home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr23 / commo642.zip / COMMO.DOC < prev    next >
Text File  |  1995-03-18  |  177KB  |  4,683 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.     {COMMO} (tm)
  7.  
  8.                    "A New Standard in Telecommunications" 
  9.  
  10.  
  11.         by Fred P. Brucker
  12.  
  13.  
  14.  
  15.  
  16.  
  17.             Part I
  18.               User Guide and Reference
  19.  
  20.  
  21.             Release 6.42
  22.               March 18, 1995
  23.  
  24.  
  25.  
  26.  
  27.  
  28.        (C)Copyright 1989-1995  Fred P. Brucker  All Rights Reserved 
  29.  
  30.  
  31.  
  32.  
  33. The {COMMO} program and associated on-disk documentation are the property
  34. of Fred P. Brucker (the "author") and may not be sold without permission. 
  35. The Shareware version may be distributed, unaltered and as a unit, via
  36. Electronic Bulletin Board Systems.
  37.  
  38. SHAREWARE DISTRIBUTORS and clubs, please see the file VENDOR.DOC for
  39. distribution guidelines.
  40.  
  41.  
  42. THE AUTHOR OF THIS PROGRAM DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR
  43. IMPLIED, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF
  44. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH REGARD TO THE
  45. SOFTWARE, THE ACCOMPANYING WRITTEN MATERIALS AND THE DISKETTES.  IN NO
  46. EVENT SHALL THE AUTHOR BE LIABLE TO YOU FOR ANY CONSEQUENTIAL, SPECIAL,
  47. INCIDENTAL OR INDIRECT DAMAGES OF ANY KIND ARISING OUT OF THE USE OF THE
  48. SOFTWARE, EVEN IF THE AUTHOR HAS BEEN SPECIFICALLY ADVISED OF THE
  49. POSSIBILITY OF SUCH DAMAGES.  IN NO EVENT WILL THE AUTHOR'S LIABILITY
  50. EXCEED THE ACTUAL PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE.
  51.  
  52. YOUR USE OF THIS PROGRAM CONSTITUTES YOUR ACCEPTANCE OF THESE TERMS.
  53.  
  54.  
  55. {COMMO} is a trademark of Fred P. Brucker.  All other trademarks and
  56. registered trademarks referenced in this document are the property of their
  57. respective owners.
  58.  
  59.  
  60.  
  61.                      ================================
  62.                      {COMMO} Registration Information
  63.                      ================================
  64.  
  65.   {COMMO} is a "SHAREWARE" product.  You are entitled to evaluate it for
  66.   30 days.  If it suits your needs and you would like to continue using
  67.   it, then you must pay the licensing fee.  Please use the REGISTRATION
  68.   FORM on the next page.
  69.  
  70.   When you REGISTER you will be licensed to use all future SHAREWARE
  71.   releases of {COMMO}.  You will never have to pay an "update" charge.
  72.   Registration allows you to eliminate delay screens and to enable extra
  73.   features (see !!!INFO.DOC for list).  Registered users will receive
  74.   priority support on Bulletin Boards and CompuServe (see !!!INFO.DOC).
  75.  
  76.   Call or write for pricing information on MULTI-USER (SITE) and
  77.   DISTRIBUTION licenses.  Discounts are given on quantities of 10 or more.
  78.  
  79.   All prices shown are US DOLLARS.  Please remit US FUNDS on US BANK only.
  80.   NET 30 TERMS will be accepted on purchase orders totalling $100.00 or
  81.   more.
  82.  
  83.   The PRINTED MANUAL is 7 x 8.5 (inches) in size and includes an index.
  84.   The DISKETTE has the latest {COMMO} release plus the latest version of
  85.   the Enhanced MOSTHOST host macro.
  86.  
  87.   For orders, inquiries and support for registered users, call MON-SAT,
  88.   9am-5pm, EASTERN time.  If you get my answering machine, please try
  89.   again later (I cannot return long distance calls).
  90.  
  91.   To register by E-mail on CompuServe or Internet, upload the completed
  92.   Registration Form as a message (text or binary).
  93.  
  94.      MAILING ADDRESS:    Fred P. Brucker
  95.                          P.O. Box 141537
  96.                          Columbus, OH 43214
  97.  
  98.      VOICE TELEPHONE:    (614) 326-1309
  99.      COMPUSERVE:         71021,356
  100.      INTERNET:           71021.356@compuserve.com
  101.  
  102.   PAYMENT OPTIONS:
  103.  
  104.   1) CHECK or MONEY ORDER:  make payable to FRED P. BRUCKER.
  105.  
  106.   2) CREDIT CARD:  fill in the credit card information at the bottom of
  107.      the Registration Form (next page).  Credit card orders may be mailed,
  108.      phoned or E-mailed via CompuServe.
  109.  
  110. --------------------------------------------------------------------------
  111.  
  112.  
  113.  
  114.                  {COMMO} 6.42 SINGLE USER REGISTRATION FORM
  115.  
  116.   Name     _______________________________________________________________
  117.  
  118.   Company name (if company address)   ____________________________________
  119.  
  120.   Address  _______________________________________________________________
  121.  
  122.            _______________________________________________________________
  123.  
  124.            _______________________________________________________________
  125.  
  126.              * All prices include shipping and handling *            Number
  127.                                                                     of Copies
  128.   {COMMO} single user license with PRINTED MANUAL and DISKETTE:
  129.          Price in USA/Canada/Mexico ....................... $ 53.00   ____
  130.          OHIO residents (includes sales tax) ..............   56.05   ____
  131.          All other countries ..............................   60.00   ____
  132.  
  133.   {COMMO} single user license, with DISKETTE:
  134.          Price in USA/Canada/Mexico ....................... $ 40.00   ____
  135.          OHIO residents (includes sales tax) ..............   42.30   ____
  136.          All other countries ..............................   42.00   ____
  137.  
  138.   Special price for BBS sysops and students, with DISKETTE:
  139.          Price in USA/Canada/Mexico ....................... $ 30.00   ____
  140.          OHIO residents (includes sales tax) ..............   31.73   ____
  141.          All other countries ..............................   32.00   ____
  142.      Sysops: BBS name and phone number ____________________
  143.      Students: name of school _____________________________
  144.  
  145.   >>>>>>>>>>>>>>>>>>  Specify if OTHER than 3.5" HD diskette: _______
  146.  
  147.  
  148.                                       Enter total AMOUNT:   $ ____________
  149.  
  150.   Payment method:  Check__  Money order__  Visa__  MasterCard__
  151.                    Carte Blanche__  Diners Club__  JCB__   PO__
  152.  
  153.  
  154.      INFORMATION FOR CREDIT CARD PURCHASES ONLY:
  155.  
  156.      Card No. ________  ________  ________  ________  Expires ____/____
  157.                                                                mo.  yr.
  158.      Cardholder signature _____________________________________________
  159.  
  160.      Cardholder name __________________________________________________
  161.  
  162.      Daytime telephone  (_____) _____ _______
  163.  
  164. --------------------------------------------------------------------------
  165.  
  166.  
  167.  
  168.  
  169.   Answers to the following questions will help me serve you better in the
  170.   future:
  171.  
  172.   How did you obtain {COMMO}?  (If BBS, please give name and phone number)
  173.  
  174.   ________________________________________________________________________
  175.  
  176.   In general terms, what do you use {COMMO} for?
  177.  
  178.   ________________________________________________________________________
  179.  
  180.   ________________________________________________________________________
  181.  
  182.   What type of computer and modem do you use?
  183.  
  184.   ________________________________________________________________________
  185.  
  186.   ________________________________________________________________________
  187.  
  188.  
  189.   Comments / Questions ___________________________________________________
  190.  
  191.   ________________________________________________________________________
  192.  
  193.   ________________________________________________________________________
  194.  
  195.   ________________________________________________________________________
  196.  
  197.   ________________________________________________________________________
  198.  
  199.  
  200.   Thank you, and I hope you enjoy {COMMO}.
  201.  
  202.  
  203.  
  204.                                     -6-
  205.  
  206. ========
  207. Contents
  208. ========
  209.  
  210.  
  211. Program Description . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  212.  
  213. Principal Features  . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  214.  
  215. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  216.  
  217. The Best Way to Learn {COMMO} Quickly . . . . . . . . . . . . . . . . .  11
  218.      Quick Start Instructions . . . . . . . . . . . . . . . . . . . . .  11
  219.      Preparing Your System  . . . . . . . . . . . . . . . . . . . . . .  12
  220.      Command Line Options . . . . . . . . . . . . . . . . . . . . . . .  14
  221.      Initialization Procedure . . . . . . . . . . . . . . . . . . . . .  16
  222.      Terminal Screen  . . . . . . . . . . . . . . . . . . . . . . . . .  16
  223.  
  224. {COMMO} Key Commands  . . . . . . . . . . . . . . . . . . . . . . . . .  17
  225.      [Alt-A]  ASCII Upload  . . . . . . . . . . . . . . . . . . . . . .  17
  226.      [Alt-B]  Send Break Signal . . . . . . . . . . . . . . . . . . . .  18
  227.      [Alt-C]  Clear Screen  . . . . . . . . . . . . . . . . . . . . . .  19
  228.      [Alt-D]  Dialing Directory . . . . . . . . . . . . . . . . . . . .  19
  229.           Dialing Directory Entry Example . . . . . . . . . . . . . . .  19
  230.      [Alt-G]  Edit Setup File . . . . . . . . . . . . . . . . . . . . .  23
  231.           Predefining Variables with SET  . . . . . . . . . . . . . . .  23
  232.           Explanation of Setup File Items . . . . . . . . . . . . . . .  24
  233.      [Alt-H]  Hang Up . . . . . . . . . . . . . . . . . . . . . . . . .  44
  234.      [Alt-I]  Screen Image Save . . . . . . . . . . . . . . . . . . . .  44
  235.      [Alt-K]  Scrollback  . . . . . . . . . . . . . . . . . . . . . . .  44
  236.      [Alt-M]  Macro File  . . . . . . . . . . . . . . . . . . . . . . .  45
  237.           Compiling Macro Files . . . . . . . . . . . . . . . . . . . .  45
  238.      [Alt-N]  Multi Number Dialing  . . . . . . . . . . . . . . . . . .  46
  239.      [Alt-O]  Send Modem Initialization String  . . . . . . . . . . . .  46
  240.      [Alt-P]  Set Terminal Parameters . . . . . . . . . . . . . . . . .  46
  241.           Parameter Descriptions  . . . . . . . . . . . . . . . . . . .  47
  242.           How to Set Terminal Parameters  . . . . . . . . . . . . . . .  48
  243.      [Alt-S]   Shell to DOS . . . . . . . . . . . . . . . . . . . . . .  49
  244.      [Alt-T]  Set Toggles . . . . . . . . . . . . . . . . . . . . . . .  49
  245.           Sound Control Toggle  . . . . . . . . . . . . . . . . . . . .  49
  246.           Local Echo Toggle . . . . . . . . . . . . . . . . . . . . . .  50
  247.           Signal Lights Toggle  . . . . . . . . . . . . . . . . . . . .  50
  248.      [Alt-U]  Utility Menu  . . . . . . . . . . . . . . . . . . . . . .  50
  249.      [Alt-W]  Send Current Password . . . . . . . . . . . . . . . . . .  50
  250.      [Alt-X]  Exit from {COMMO} . . . . . . . . . . . . . . . . . . . .  51
  251.      [Alt-1]  Capture File Options  . . . . . . . . . . . . . . . . . .  51
  252.      [Alt-2]  Print Log Toggle  . . . . . . . . . . . . . . . . . . . .  52
  253.      [Alt--]  Chat Mode Toggle  (Alt minus) . . . . . . . . . . . . . .  52
  254.      [Alt-=]  Doorway Mode Toggle . . . . . . . . . . . . . . . . . . .  53
  255.      [F1]  How to Use Online Help . . . . . . . . . . . . . . . . . . .  54
  256.           Modifying the Help File . . . . . . . . . . . . . . . . . . .  55
  257.  
  258. [PgUp]/[PgDn]  Uploading/Downloading  . . . . . . . . . . . . . . . . .  55
  259.  
  260.  
  261.  
  262.                                     -7-
  263.  
  264.      Internal Protocols . . . . . . . . . . . . . . . . . . . . . . . .  55
  265.      ASCII Upload/Download  . . . . . . . . . . . . . . . . . . . . . .  57
  266.      External Protocols . . . . . . . . . . . . . . . . . . . . . . . .  57
  267.      Using HS/Link  . . . . . . . . . . . . . . . . . . . . . . . . . .  58
  268.      Using Kermit . . . . . . . . . . . . . . . . . . . . . . . . . . .  58
  269.      Using OZBEXT . . . . . . . . . . . . . . . . . . . . . . . . . . .  58
  270.      External Zmodem  . . . . . . . . . . . . . . . . . . . . . . . . .  58
  271.      {COMMO} Auto Receive . . . . . . . . . . . . . . . . . . . . . . .  59
  272.  
  273. Keyboard Macros: Customizing Key Commands . . . . . . . . . . . . . . .  60
  274.  
  275. Appendix A:  Setting Up Your Modem  . . . . . . . . . . . . . . . . . .  62
  276.      Answering a call from another computer . . . . . . . . . . . . . .  63
  277.      Connecting two computers (null modem cable)  . . . . . . . . . . .  64
  278.  
  279. Appendix B   {COMMO} and Multi-Tasking  . . . . . . . . . . . . . . . .  65
  280.      DESQview . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  65
  281.      OS/2 and Windows . . . . . . . . . . . . . . . . . . . . . . . . .  66
  282.      OmniView . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  66
  283.      DoubleDOS  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  67
  284.  
  285. Appendix C   Flow Control . . . . . . . . . . . . . . . . . . . . . . .  68
  286.  
  287. Appendix D   ASCII Character Representation . . . . . . . . . . . . . .  69
  288.  
  289. Appendix E   Terminal Emulation . . . . . . . . . . . . . . . . . . . .  71
  290.      ANSI-BBS Keyboard Support  . . . . . . . . . . . . . . . . . . . .  71
  291.      VT102 Keyboard Simulation  . . . . . . . . . . . . . . . . . . . .  71
  292.      VT220 Keyboard Simulation  . . . . . . . . . . . . . . . . . . . .  72
  293.      Printer Support  . . . . . . . . . . . . . . . . . . . . . . . . .  73
  294.  
  295. Appendix F   Usage Log Format . . . . . . . . . . . . . . . . . . . . .  75
  296.  
  297. Appendix G   Error Message Explanations . . . . . . . . . . . . . . . .  77
  298.  
  299. Appendix H   {COMMO} Macro Key-labels . . . . . . . . . . . . . . . . .  81
  300.      Table of PREDEFINED Key-labels . . . . . . . . . . . . . . . . . .  81
  301.      USER-DEFINED Key-labels  . . . . . . . . . . . . . . . . . . . . .  82
  302.  
  303. Appendix I   List of Reserved Variables . . . . . . . . . . . . . . . .  83
  304.  
  305. Appendix J   Macro Functions Listed by Class  . . . . . . . . . . . . .  85
  306.  
  307. Appendix K   {COMMO} Support Files  . . . . . . . . . . . . . . . . . .  88
  308.      The Internal Editor  . . . . . . . . . . . . . . . . . . . . . . .  88
  309.      Using an External Editor . . . . . . . . . . . . . . . . . . . . .  88
  310.      The Setup File, COMMO.SET  . . . . . . . . . . . . . . . . . . . .  89
  311.      The Dialing Directory, COMMO.FON . . . . . . . . . . . . . . . . .  89
  312.      The Resident Macro File, COMMO.MAC . . . . . . . . . . . . . . . .  90
  313.      The Auxiliary Macro File . . . . . . . . . . . . . . . . . . . . .  90
  314.      The Online Help File, COMMO.HLP  . . . . . . . . . . . . . . . . .  90
  315.      Changes to the Support Files . . . . . . . . . . . . . . . . . . .  90
  316.  
  317.  
  318.  
  319.                                     -8-
  320.  
  321. ==========  Program Description
  322.  
  323. {COMMO} is a high-performance communications program.  The comprehensive
  324. macro programming (script) language provides the power to customize the
  325. program and to automate any online or offline procedure.
  326.  
  327. {COMMO} handles high speed modems with ease, is multi-tasker aware and uses
  328. plain text support files (Setup File, Dialing Directory and Macro Files). 
  329. It is small in size, yet has an amazing amount of functionality (it is
  330. written entirely in assembly language).
  331.  
  332. And {COMMO} is elegant, easy to learn and fun to use!
  333.  
  334. See the full list of features starting on the next page.
  335.  
  336.  
  337. Minimum system configuration:
  338.  
  339.      IBM PC compatible computer.
  340.      MS-DOS 2.1 or higher.
  341.      128k of memory.
  342.      One diskette drive.
  343.      A serial port or internal modem with an 8250, 16450 or 16550
  344.        compatible UART chip.
  345.      {COMMO} can be configured to work with any type of modem.
  346.  
  347.  
  348.  
  349. {COMMO} is pronounced cah'mo.  It's technical jargon for "communications."
  350.  
  351.  
  352.  
  353.  
  354.  
  355.                                   {COMMO}
  356.  
  357.                    "A New Standard in Telecommunications"
  358.  
  359.  
  360.  
  361.                                     -9-
  362.  
  363. ==========  Principal Features
  364.  
  365. {COMMO} is small in size, loads rapidly and performs all functions with
  366. great speed.
  367.  
  368. The powerful Macro Language allows you to:
  369.  
  370.       *   Write macro "scripts" to automate many common operations such as
  371.           logging in, reading messages, uploading/downloading.  {COMMO}
  372.           will even perform these tasks in the middle of the night while
  373.           you sleep.
  374.  
  375.       *   Assign Function Keys, Alt Keys, Keypad Keys, etc., to:
  376.           - Send a string to the modem
  377.           - Execute any DOS command
  378.           - Start any macro
  379.           - Initiate any {COMMO} function.
  380.  
  381.       *   Create pop-up menus with "hot keys" to start any macro.
  382.  
  383.       *   Edit all macros without exiting {COMMO}, using the Internal
  384.           Editor (or your external editor).  Macros become effective
  385.           immediately.
  386.  
  387.       *   Call your computer from a remote location using {COMMO}'s
  388.           convenient Host Mode, written in {COMMO}'s macro language.
  389.  
  390.       *   Macros can be compiled to improve speed, size and security.
  391.  
  392. The free-form Dialing Directory can hold an unlimited number of entries. 
  393. Multi Number Dialing is supported from the command line.  A macro may be
  394. linked to each directory entry.
  395.  
  396. Built-in file transfer protocols include Zmodem, Ymodem and Xmodem.  An
  397. upload file selection macro is provided.
  398.  
  399. Multi-tasking support.  {COMMO} is fully DESQview aware, operates in far
  400. less memory than comparable programs.  Also supports OS/2, Windows,
  401. OmniView, DoubleDOS and others.
  402.  
  403. Swap to disk is optional when shelling to DOS or executing external
  404. programs.  The resident program kernel occupies about 8k of memory.
  405.  
  406. Built-in ANSI-BBS and VT102 emulation.  Supports ANSI editing functions,
  407. scrolling region, 132 column mode, graphics character set, tab set/clear,
  408. printing, modes, reports, etc.  Complete auto-switching VT102 or VT220
  409. keyboard support via Macros.
  410.  
  411. ENQ/ACK terminal protocol support.
  412.  
  413. ASCII Upload to send messages and text files.  Features line pacing and
  414. blank line expansion.
  415.  
  416.  
  417.  
  418.                                     -10-
  419.  
  420. The Setup File, Dialing Directory and Macro File are plain text files and
  421. may be edited with the full-function Internal Editor, or with any external
  422. editor.
  423.  
  424. Any file up to 64k in size may be edited within {COMMO} using the Internal
  425. Editor.
  426.  
  427. String search is available in all support file windows.
  428.  
  429. {COMMO} supports all text display modes, including 132 column screens.
  430.  
  431. Character Translate Tables for both sending and receiving.  Tables can be
  432. modified dynamically via macros.
  433.  
  434. Split-screen Chat Mode for communicating with another computer which is
  435. also running a terminal program.  All program features are available while
  436. in Chat Mode.
  437.  
  438. Doorway Mode lets you operate remote applications with full use of your
  439. screen and keyboard.
  440.  
  441. {COMMO}'s Auto Receive feature lets you configure any 16 strings to
  442. automatically trigger any 16 macros.  Thus any protocol with a "signature"
  443. can be set to start automatically.  Zmodem and HS/Link are pre-configured.
  444.  
  445. Support for any eight serial ports.  Port addresses and IRQ's are
  446. configurable (including IRQ 8 to 15).  Port speeds up to 115,200 bps. 
  447. Automatic support for NS16550A (or AF) buffered UART chip.
  448.  
  449. Serial port signal lights may be displayed on the Status Line, including
  450. send and receive.  Very useful with internal modems.
  451.  
  452. Scrollback buffer up to 64k bytes gives instant replay of the text that has
  453. scrolled off the screen.
  454.  
  455. Capture Log saves all text from the screen to a disk file.  Three different
  456. capture modes are available.
  457.  
  458. Screen Image Save writes the current screen to a disk file.
  459.  
  460. Print Log writes all text from the screen to the printer.
  461.  
  462. Usage Log records date, time, length of call and other information about
  463. each call.  Date of last call can be saved in the Dialing Directory.
  464.  
  465. Date and time formats used in logs and displays are configurable for use in
  466. any country.
  467.  
  468. Support for visually impaired users with {COMMO}'s configurable Speech
  469. Friendly Interface (use the "/b" command line switch or set {sfi=yes} in
  470. COMMO.SET).
  471.  
  472. Extensive context-related Online Help.
  473.  
  474.  
  475.  
  476.                                     -11-
  477.  
  478. ==========  Getting Started
  479.  
  480. NOTE:  Refer to Appendix G for explanations of any error messages you
  481. receive during your initial use of {COMMO}.
  482.  
  483. For greater detail, see the next section "Preparing Your System."
  484.  
  485.  
  486. -----=====  The Best Way to Learn {COMMO} Quickly
  487.  
  488. 1)   Read "Getting Started," which will get you up and running.
  489.  
  490. 2)   Read Appendix A "Setting Up Your Modem" for some very important
  491.      instructions.
  492.  
  493. 3)   Read through the section "{COMMO} Key Commands" to familiarize
  494.      yourself with {COMMO}'s commands and features.
  495.  
  496. 4)   Use Online Help as a reference while you use {COMMO}.
  497.  
  498.  
  499. -----=====  Quick Start Instructions
  500.  
  501. 1)   If you have a hard drive, create a subdirectory named "COMMO."  Copy
  502.      all of the files from the {COMMO} archive or distribution diskette
  503.      into this subdirectory.
  504.  
  505.      If your system has only floppy drives, copy the {COMMO} files to a
  506.      formatted diskette.
  507.  
  508.      Now change to the {COMMO} subdirectory or log in to the diskette where
  509.      you have copied the {COMMO} files.
  510.  
  511. 2)   Run the "New User's Guide"  by typing "guide" at the DOS prompt.
  512.      Follow the instructions carefully.  A macro will automatically take
  513.      you on a tour of some of {COMMO}'s main features.
  514.  
  515.      When you are in the Setup File you will be in {COMMO}'s Internal
  516.      Editor and you may change any part of the file using the arrow keys,
  517.      PgUp, PgDn and other editing keys.  Press Alt-E for Edit Help to see a
  518.      list of editing keys.
  519.  
  520.      You may need to change some of the items to conform to your system
  521.      setup.  Notice that {COMMO} only looks at the items that are contained
  522.      in curly braces: e.g., {min=yes}.  All other text is treated as
  523.      commentary and is not used by the program.
  524.  
  525.      Most items will not need to be changed until you are more familiar
  526.      with {COMMO}.  For now, check the following:
  527.  
  528.           The Default Dialing Parameters in the first item.  Make sure you
  529.           have the correct port number (the third field).  If your modem is
  530.  
  531.  
  532.  
  533.                                     -12-
  534.  
  535.           on COM2, change it to "2", COM3 to "3", etc.  Using COM2 it would
  536.           look like this:  {38400,8n1,2,A,0}.
  537.  
  538.           The Modem Initialization String.  If you know the commands for
  539.           your own modem, make the necessary adjustments.  If you don't,
  540.           then leave it like it is.  Refer to Appendix A for more
  541.           information.
  542.  
  543.           The items under "Paths and Files" (page down to see these). 
  544.  
  545.      Press [Esc] to save the file and continue the tour.
  546.  
  547. 3)   The next stop is the Dialing Directory.  To alter an entry or to add
  548.      new ones, just press "E" to enter edit mode.  This is the same
  549.      Internal Editor you used to modify the Setup File.  When you are
  550.      finished making changes, press Esc to bring back the Selector Bar. 
  551.      Then press Esc again to continue.
  552.  
  553. 4)   Next you will see a sample menu created by a {COMMO} macro.  Press
  554.      Enter to continue and return to the Terminal Screen.  Then exit
  555.      {COMMO} with the Alt-X command.
  556.  
  557. 5)   From the DOS prompt type "commo<cr>" to restart the program.  The new
  558.      Setup File items will now be in effect.
  559.  
  560. 6)   When you see the Status Line at the bottom of the screen, you are in
  561.      the Terminal Screen.  Now you may press Alt-D to enter the Dialing
  562.      Directory.  Use the up and down arrow keys to select a system to call
  563.      and press Enter.  {COMMO} will begin dialing.
  564.  
  565. 7)   When a connection is made with a remote system, {COMMO} will return to
  566.      the Terminal Screen where you may interact with the remote.
  567.  
  568.      NOTE:  If your modem does not seem to operate properly (no connection
  569.      is made or the data is garbled), read Appendix A "Setting Up Your
  570.      Modem."  You may need to change the Modem Initialization String in the
  571.      Setup File.  If you change it, you will need to exit {COMMO} and
  572.      restart the program.  Then try dialing again.
  573.  
  574.  
  575. -----=====  Preparing Your System
  576.  
  577. The following sections give startup instructions in greater detail.
  578.  
  579. Make sure that all of the files from the {COMMO} package are in one
  580. directory or on one diskette.  Four of these files are required to run the
  581. {COMMO} program:
  582.  
  583.      COMMO.EXE, the Program File
  584.      COMMO.SET, the Setup File
  585.      COMMO.FON, the Dialing Directory File
  586.      COMMO.MAC, the Macro File
  587.  
  588.  
  589.  
  590.                                     -13-
  591.  
  592. In addition, if Online Help is used (recommended):
  593.  
  594.      COMMO.HLP, the Online Help File
  595.  
  596. There are two ways to make sure that {COMMO} will be able to find all of
  597. its files.  The first method is the simplest and should be used if you are
  598. not too familiar with DOS commands:
  599.  
  600. 1)   Make sure you are logged into the directory or disk drive where the
  601.      files are located.  Then simply type "commo" at the DOS prompt.  If
  602.      your files are in the directory "C:\COMMO" you would type:
  603.  
  604.           c:<cr>
  605.           cd \commo<cr>
  606.           commo<cr>
  607.  
  608.      (<cr> is the [Enter] or Return key)
  609.  
  610.      Or if the files are on a diskette in drive A you would type:
  611.  
  612.           a:<cr>
  613.           commo<cr>
  614.  
  615.      {COMMO} will remember where the files are, so you will be able to
  616.      change directory or drive later without concern.
  617.  
  618. 2)   The second method is a little more advanced, but allows you to run
  619.      {COMMO} no matter which directory or drive you are currently logged
  620.      into.  Use the SET command in DOS to store the {COMMO} path into the
  621.      "environment."  If you place this command in your AUTOEXEC.BAT file
  622.      you won't have to change directories or diskettes to run {COMMO}.  If
  623.      your files are in the directory "C:\COMMO" the command would be:
  624.  
  625.           set commo=c:\commo
  626.  
  627.      If the files are on the diskette in drive B the command would be:
  628.  
  629.           set commo=b:
  630.  
  631.      Do not use any extra spaces in the SET command.  And remember to place
  632.      the {COMMO} directory or drive in your PATH command.
  633.  
  634.      IMPORTANT!  Be sure to check your "set commo=" command if you install
  635.      {COMMO} into a different directory or onto another drive (or if you
  636.      install a later release of the program).  If it points to the wrong
  637.      directory, {COMMO} will not operate properly.
  638.  
  639.  
  640.  
  641.                                     -14-
  642.  
  643. -----=====  Command Line Options
  644.  
  645.  
  646. ----------  Dialing Strings
  647.  
  648. Dialing Strings are used to indicate numbers to dial at program startup. 
  649. If present, they must be placed before any command line switches.  {COMMO}
  650. will search the Dialing Directory for each string and mark the first entry
  651. where a match is found (case is ignored).
  652.  
  653. The strings may consist of any part of a Dialing Directory entry line
  654. (usually part of the system name) and may be separated by commas or spaces. 
  655. The following characters may not appear in a command line Dialing String:
  656. space, comma, slash (/), curly braces.
  657.  
  658. After entries in the Dialing Directory are marked, {COMMO} will check for a
  659. startup macro (specified on the command line or in the Setup File).  If a
  660. startup macro is present, it will be started.  Otherwise Multi Number
  661. Dialing of the marked systems will begin.
  662.  
  663. Examples:
  664.  
  665.      commo telegodzilla joes-bbs 4567 
  666.  
  667.      commo zilla,joes,4567
  668.  
  669. IMPORTANT!  The Modem Initialization String will normally be sent before
  670. dialing begins.  Your modem should be turned on and ready to receive the
  671. command string before you start {COMMO}.
  672.  
  673.  
  674. ----------  Switches
  675.  
  676. Case is ignored and the switches may be in any order (Dialing Strings must
  677. precede all switches, however).
  678.  
  679. NOTE:  Environment variables may also be used to communicate data to
  680. {COMMO} at program startup.  See the description of the SETVariable
  681. function in Part II (MACRO.DOC).
  682.  
  683. /:label             Startup Macro.
  684.  
  685.      This switch can be used to override the "mac=" item in the Setup File. 
  686.      The "label" is a one to eight character macro label.  If the label is
  687.      found in the Macro File, macro execution will be started.  If the
  688.      label is not found the switch will be ignored.
  689.  
  690. /sfilename      Alternate Setup File         (default is COMMO.SET).
  691. /dfilename      Alternate Dialing Directory  (default is COMMO.FON).
  692. /mfilename      Alternate Macro File         (default is COMMO.MAC).
  693. /hfilename      Alternate Online Help File   (default is COMMO.HLP).
  694.  
  695.  
  696.  
  697.                                     -15-
  698.  
  699.      Only the filename should be specified.  The {COMMO} home directory
  700.      will be assumed for the path.
  701.  
  702.      If an alternate Macro File is specified, it will become the resident
  703.      Macro File (its name will be the value of the built-in variable
  704.      "_mac").
  705.  
  706. /knn                Scrollback Buffer size.
  707.  
  708.      This switch will override the "sbs=" item in the Setup File.  "nn" is
  709.      kilobytes and may be 0 to 64.
  710.  
  711. /vnnnnn             Size of String Variable Space.
  712.  
  713.      The size of String Variable Space can be adjusted from 512 bytes to
  714.      65535 bytes.  The default is 3072 bytes.
  715.  
  716. /iy or /in          Modem Initialization override.
  717.  
  718.      Forces the Modem Initialization String to be sent ("/iy") or not sent
  719.      ("/in").  This will override the "min=" item in the Setup File.
  720.  
  721. /{parms}            Default Dialing Parameters
  722.  
  723.      Any or all parameters may be specified.  Included parameters will
  724.      override those in the "ddp=" item in the Setup File.
  725.  
  726. /b                  Enable Speech Friendly Interface
  727.  
  728.      This switch is used to force SFI to ON for the current session only. 
  729.      Users with speech synthesizers should set {sfi=yes} in COMMO.SET for
  730.      permanent SFI (the switch will no longer be needed).
  731.  
  732.  
  733. Command line example:
  734.  
  735.      commo joes zilla /:mailrun /dother.dir /k25 /v2000 /in
  736.  
  737.       *   Two systems will be marked in the Dialing Directory.
  738.  
  739.       *   The macro "mailrun" will be started if it exists in the Macro
  740.           File.
  741.  
  742.       *   The alternate Dialing Directory "other.dir" will be loaded.
  743.  
  744.       *   The Scrollback Buffer will be set to 25k in size.
  745.  
  746.       *   The size of String Variable Space is set to 2000 bytes.
  747.  
  748.       *   The Modem Initialization String will not be sent.
  749.  
  750.  
  751.  
  752.                                     -16-
  753.  
  754. -----=====  Initialization Procedure
  755.  
  756. When {COMMO} begins running it will read and process the Setup File,
  757. COMMO.SET.  Then it will attempt to load into memory:
  758.  
  759.      1) COMMO.MAC, the resident Macro File
  760.      2) COMMO.FON, the Dialing Directory
  761.  
  762. Any problems encountered will be reported.  These problems must be
  763. corrected before restarting the program.
  764.  
  765. Automatic modem initialization will occur if requested in the Setup File
  766. with {min=yes}, or by the "/iy" command line switch.  Use the "/in" switch
  767. to suppress modem initialization if you are already on line.
  768.  
  769. {COMMO} will adapt to any video text mode that is set when the program is
  770. started.  Check the items under "Video and Chat Mode" in the Setup File if
  771. you need to change the video mode.  These items are described in more
  772. detail in the section "[Alt-G]  Edit Setup File" later in this document.
  773.  
  774. If the display does not look right try executing the DOS command  "mode
  775. co80" or "mode bw80" prior to calling {COMMO}.
  776.  
  777.  
  778. -----=====  Terminal Screen
  779.  
  780. The Terminal Screen allows you to see the characters coming in from the
  781. serial port.  Any characters that you type will be sent out to the serial
  782. port.  If you are connected to another system you will be interacting with
  783. that system.
  784.  
  785. Keep in mind that you will also be interacting with {COMMO} and with your
  786. own computer via key commands (Alt keys, for example).  These key commands
  787. have no effect on the remote system unless they cause characters to be sent
  788. to the serial port (pressing Alt-W to send your password, for example).
  789.  
  790.  
  791.  
  792.                                     -17-
  793.  
  794. ==========  {COMMO} Key Commands
  795.  
  796. The Alt Keys shown in this section are the built-in default key assignments
  797. for the various {COMMO} commands.  Once you are familiar with these
  798. commands you may use macros to reassign any of the keys.
  799.  
  800. Keys used within the various command windows are properly detailed in
  801. Online Help.  Please press F1 from any command window to invoke {COMMO}'s
  802. context-related help system.
  803.  
  804. Note that certain program features are available only in macros.  Refer to
  805. Part II (MACRO.DOC) for details.
  806.  
  807.  
  808. -----=====  [Alt-A]  ASCII Upload
  809.  
  810. This command is used to send prepared messages or any text files to the
  811. remote system.  Enter the path\filename of the file you wish to send.  Note
  812. that the input field will be blank unless a macro is used to prompt with a
  813. path.  The macro supplied in COMMO.MAC is:
  814.  
  815.      {:ala} {ascii %uldir\} {}    ASCII Upload with path
  816.  
  817. Notice the "\" following the path variable.  It tells {COMMO} to prompt for
  818. the filename.  If you needed to specify a colon for pacing (see below) you
  819. could change this to:
  820.  
  821.      {:ala} {ascii %uldir\,:} {}    ASCII Upload with path
  822.  
  823. There is no special error checking associated with ASCII Upload.  It is
  824. intended primarily for sending message responses and other short text
  825. files.  For longer files, binary files or compressed files (.ZIP, .ARJ,
  826. etc.) you will want to use error checking protocols such as Ymodem, Zmodem,
  827. etc.  See "Uploading / Downloading."
  828.  
  829. A number of parameters are used to control an ASCII Upload:
  830.  
  831.  
  832. ----------  Line Pacing
  833.  
  834. IMPORTANT!  Line Pacing is used to keep transmitted data synchronized with
  835. received data (echoed from the host) and is normally used ONLY when the
  836. remote is sending a prompt for each line, usually "nn:" or "nn?".  "nn" is
  837. a line number and ":" or "?" is the prompt or "pacing character."
  838.  
  839. {COMMO} will wait up to 5 seconds for the pacing character, then send the
  840. next line.  If there is a 5 second delay between the sending of each line,
  841. then either you have the wrong pacing character or you don't need line
  842. pacing (you don't need it when using a full-screen editor, for example).
  843.  
  844. At any time, the Spacebar may be pressed to force transmission of the next
  845. line.  This is very useful when you have set the wrong pacing character or
  846.  
  847.  
  848.  
  849.                                     -18-
  850.  
  851. if you wish to send each line manually.  In the latter case, use any pacing
  852. character that is different from the one in the line prompt.
  853.  
  854. To use line pacing, enter the pacing character when {COMMO} asks for it in
  855. the ASCII Upload window.  NOTE:  The receive Translate Table can affect the
  856. pacing character if receive translation is ON.
  857.  
  858. The initial pacing character is configurable.  See "[Alt-G]  Edit Setup
  859. File."
  860.  
  861. The pacing character may be any character including control characters,
  862. e.g. "^m" or "|" for carriage return.  See Appendix D for details on how to
  863. represent special characters.
  864.  
  865. See also Appendix C "Flow Control."
  866.  
  867.  
  868. ----------  Character Pacing
  869.  
  870. You may insert a delay between each character using the Inter-Character
  871. Delay feature.  This should only be used when the remote system is so slow
  872. that it drops characters.  See "Set Terminal Parameters" for details.
  873.  
  874.  
  875. ----------  Stripping Linefeeds
  876.  
  877. Normally you will want to strip linefeeds from your outgoing text.  At the
  878. remote, this will appear as if you are typing the data (e.g., into a
  879. message editor).  But if all your data displays on the same line at the
  880. remote, then you must configure {COMMO} to send the linefeeds.
  881.  
  882. NOTE:  This item is initialized in the Setup File.
  883.  
  884.  
  885. ----------  Expanding Blank Lines
  886.  
  887. You may configure {COMMO} to send a space character whenever a blank line
  888. is encountered in the text file you are sending.  This will prevent your
  889. message from terminating prematurely (message editors often end the message
  890. on an empty line).  Blank line expansion is not normally required when
  891. sending to a "full screen" BBS editor.
  892.  
  893. NOTE:  This item is initialized in the Setup File.
  894.  
  895.  
  896. -----=====  [Alt-B]  Send Break Signal
  897.  
  898. A one second Break Signal will be sent.  This signal is used by some online
  899. systems to interrupt certain operations.  Use it only when the remote
  900. system directs you to do so.
  901.  
  902. NOTE:  The duration of the Break Signal may be varied using the BREAk macro
  903. function.  See Part II (MACRO.DOC) for details.
  904.  
  905.  
  906.  
  907.                                     -19-
  908.  
  909.  
  910.  
  911. -----=====  [Alt-C]  Clear Screen
  912.  
  913. The Terminal Screen will be cleared and the current colors will be set to
  914. the Setup File defaults.
  915.  
  916.  
  917. -----=====  [Alt-D]  Dialing Directory
  918.  
  919. The Dialing Directory is your database of telephone numbers.  From the
  920. directory window you can select numbers to dial.  You can also update the
  921. directory using the Internal Editor, dial a number manually or load a new
  922. directory.
  923.  
  924. Refer to Online Help for a complete description of the commands available
  925. in the Dialing Directory window.
  926.  
  927.  
  928. ----------  Dialing Directory Entry Example
  929.  
  930. File City BBS  {555-1234}  {pword}  {fcbbs}  {}  07/24/93
  931.      [1]          [2]        [3]      [4]    [5]   [6]
  932.  
  933.      where:
  934.                1.  The System Name
  935.                2.  Telephone number
  936.                3.  Password for this system
  937.                4.  Linked Macro
  938.                5.  Terminal Parameters
  939.                6.  Date Last Called
  940.  
  941. TIPS on creating Dialing Directory entries:
  942.  
  943.  *   Any number of string variable items may be added following the
  944.      Terminal Parameters item (see below).
  945.  
  946.  *   Do not use extra spaces within the curly braces (except in the phone
  947.      number field).
  948.  
  949.  *   Items in curly braces are positional and must be present if any
  950.      subsequent items are present on the same line.  Items which are not
  951.      used may have a null string {} as a placeholder (null strings at the
  952.      end of the line may be omitted).
  953.  
  954.  *   Directory entries are limited to one per line.  Lines may be up to 255
  955.      characters in length.  {COMMO}'s Internal Editor will scroll
  956.      horizontally to follow the cursor.
  957.  
  958.  *   Comments may be placed anywhere outside the curly braces or on
  959.      separate lines.
  960.  
  961.  
  962.  
  963.                                     -20-
  964.  
  965. ----------  1. System Name:  File City BBS
  966.  
  967.      Up to 40 characters in length,  it must NOT be enclosed in curly
  968.      braces.  The System Name will be displayed on the Status Line after
  969.      connection (if the Signal Lights option is not selected).  It will
  970.      also be part of a Usage Log entry if the log is enabled.
  971.  
  972.  
  973. ----------  2. Telephone Number:  {1-707-555-1234}
  974.  
  975.      The Dialing Prefix, Telephone Number and Dialing Suffix are strung
  976.      together to form a dialing command (may be up to 128 characters
  977.      total).  Spaces and hyphens are ignored by most modems (your modem
  978.      manual has more detailed information on dialing commands).
  979.  
  980.      Normally the default Dialing Prefix (usually "ATDT") and the default
  981.      Dialing Suffix (usually "|") will be used.  These are specified in the
  982.      Setup File.  You may also have any number of alternate prefixes and
  983.      suffixes by defining them with SET items in the Setup File.
  984.  
  985.      For example, you might need to turn off modem error-correction when
  986.      calling a non-error-correcting modem.  The commands to control this
  987.      vary from modem to modem, but let's assume that the command is "\N0"
  988.      to turn it off and "\N3" to turn it on.  Then the Dialing Prefix you
  989.      would use for the entries where you want it off should be "AT \N0 DT"
  990.      (spaces optional).  To define this prefix, you could have this item in
  991.      your Setup File:
  992.  
  993.           {set no_ec,AT \N0 DT}    Prefix to turn off EC
  994.  
  995.      The directory entry to use it would be as follows:
  996.  
  997.           File City  {%no_ec%555-1234} {pword} {city} {}
  998.  
  999.      The default prefix would contain the command to turn error-correction
  1000.      back on:
  1001.  
  1002.           {set _dialpf,AT \N3 DT}    Default Dialing Prefix
  1003.  
  1004.      The prefix "no_ec" will override the default prefix if it is at the
  1005.      very beginning of the telephone number field (immediately following
  1006.      the left curly brace).  Similarly, an override suffix may be specified
  1007.      if it is at the very end of the field (immediately preceding the right
  1008.      curly brace).
  1009.  
  1010.      Notice that these are variable names and must be bracketed between "%"
  1011.      characters.  Variables may be placed anywhere else within the number
  1012.      field as well, but they will not override the default prefix or suffix
  1013.      unless they are at the very beginning or very end, respectively
  1014.      (insert a space between the variable and the curly brace if you want
  1015.      the default AND the variable).
  1016.  
  1017.  
  1018.  
  1019.                                     -21-
  1020.  
  1021.      You may use variables defined with SET items in the Setup File or
  1022.      variables set within macros.
  1023.  
  1024.      IMPORTANT!  The tilde (~) will not work as a delay in the dialing
  1025.      command.  This is because the modem does not start dialing until it
  1026.      receives a carriage return (the Default Suffix).  Therefore you must
  1027.      use the modem's own delay character, which is usually a comma (,). 
  1028.      For example, use the following prefix to disable Call Waiting (with
  1029.      most tone systems):
  1030.  
  1031.           {set _dialpf,ATDT *70,}    Default Dialing Prefix
  1032.  
  1033.      This will cause the modem to dial "*70" and then delay two seconds
  1034.      before sending the telephone number.
  1035.  
  1036.      NOTE:  If you dial an entry in the directory and the telephone number
  1037.      field is NULL (no characters between the left and right curly braces),
  1038.      then {COMMO} will act exactly as if a connection had been made --
  1039.      WITHOUT actually dialing.  The password and any variables will be
  1040.      defined and the Linked Macro will be started.  This is useful when you
  1041.      want to "call" a host that is on a "direct connection."
  1042.  
  1043.  
  1044. ----------  3. System Password:  {pword}
  1045.  
  1046.      A different Password String may be defined for each system that you
  1047.      call.  Passwords may be up to 64 characters in length.
  1048.  
  1049.      The Password String may be sent by pressing Alt-W or by using the
  1050.      variable "_pas" in a SEND macro function.
  1051.  
  1052.      Passwords are invisible in the Dialing Directory window, but appear
  1053.      when you enter [E]dit mode.
  1054.  
  1055.      Rules for writing passwords are in Appendix D.
  1056.  
  1057.  
  1058. ----------  4. Linked Macro:  {fcbbs}
  1059.  
  1060.      The general form for this item is:
  1061.  
  1062.           {label,filename}
  1063.  
  1064.                label
  1065.                     A macro label where execution is to start (optional). 
  1066.                     The label may be located in the resident Macro File or
  1067.                     in the current auxiliary file.
  1068.  
  1069.                filename
  1070.                     The filename of a Macro File (optional).  If the file
  1071.                     is not already in memory (resident or auxiliary), it
  1072.                     will be loaded as the auxiliary prior to searching for
  1073.                     the label.
  1074.  
  1075.  
  1076.  
  1077.                                     -22-
  1078.  
  1079.  
  1080.      Examples:
  1081.  
  1082.           {fcbbs}
  1083.                Start at the label "fcbbs".
  1084.  
  1085.           {mailrun,fcbbs.mac}
  1086.                Start at the label "mailrun" after loading the auxiliary
  1087.                Macro File "fcbbs.mac".
  1088.  
  1089.           {,fcbbs.mac}
  1090.                Load the auxiliary Macro File "fcbbs.mac" and enter manual
  1091.                mode (no label given).
  1092.  
  1093.      If a valid label is specified, the Linked Macro will be started when a
  1094.      connection is established with the remote system.  If no macro is
  1095.      specified (or the macro label is not found), {COMMO} will enter the
  1096.      Terminal Screen in manual mode.
  1097.  
  1098.      Additional options are available when using the DIAL macro function. 
  1099.      See Part II (MACRO.DOC) for details.
  1100.  
  1101.  
  1102. ----------  5. Terminal Parameters:  {}
  1103.  
  1104.      This item allows you to override any or all of the Default Dialing
  1105.      Parameters for the current call.
  1106.  
  1107.      The Default Dialing Parameters are initialized with the "ddp=" item in
  1108.      the Setup File and may be changed during a session with the Alt-P key
  1109.      command (press F2) or with the DPARms macro function.
  1110.  
  1111.      Prior to dialing each number, {COMMO} will set all current Terminal
  1112.      Parameters to the Dialing Defaults.  Then it will set any overrides
  1113.      specified in this item.
  1114.  
  1115.      The general form for this item is:
  1116.  
  1117.           {speed,format,comport,terminal-type,delay}
  1118.  
  1119.      For example, you might have:
  1120.  
  1121.           {,7,,V}
  1122.  
  1123.      which would set the Data Format to "7e1" and the Terminal-type to
  1124.      VT102, but would use the Dialing Defaults for the other parameters.
  1125.  
  1126.      See "Set Terminal Parameters" for a complete description of each
  1127.      field.
  1128.  
  1129.  
  1130.  
  1131.                                     -23-
  1132.  
  1133. ----------  6. Last Called:  07/24/93
  1134.  
  1135.      If this item is present, {COMMO} will replace it with the current date
  1136.      whenever a connection is made with the system.  It may appear anywhere
  1137.      on the entry line, even within curly braces.  Place "00/00/00" to
  1138.      start it.
  1139.  
  1140.  
  1141. ----------  Variable Items:  {name,string}
  1142.  
  1143.      Any number of Variable Items may be included in a directory entry and
  1144.      will be set just prior to dialing.  The "string" may not contain any
  1145.      variables.  The first Variable Item must follow the Terminal
  1146.      Parameters item (all other items must be present as placeholders even
  1147.      if some are null).  Example (must be on a single line):
  1148.  
  1149.           Joes-BBS  07/24/93  {555-1234} {pword} {mac} {}
  1150.           {bbsid,joesbbs} ...
  1151.  
  1152. See also "[Alt-N]  Multi Number Dialing."
  1153.  
  1154.  
  1155. -----=====  [Alt-G]  Edit Setup File
  1156.  
  1157. Pressing Alt-G allows you to edit the Setup File, COMMO.SET (see "Internal
  1158. Editor" in Online Help for details on editing).  The Setup File contains
  1159. initial settings for many parameters used by {COMMO}.
  1160.  
  1161. Items changed with the editor are not effective until the next time you
  1162. start the program.  However, most items may be temporarily changed with key
  1163. commands and/or macro functions while the program is running.
  1164.  
  1165. Each item in the Setup File is enclosed in curly braces.  Items are
  1166. designated with three letter "keywords" and may be present in any order. 
  1167. There are no "required" items.  Most missing items will take on the default
  1168. values shown in the examples below (AUT items and SET items have no default
  1169. values).
  1170.  
  1171. All text outside the curly braces is commentary and is ignored by {COMMO}. 
  1172. Avoid using curly braces other than to bracket setup items.
  1173.  
  1174.  
  1175. ----------  Predefining Variables with SET
  1176.  
  1177. SET items predefine variables in {COMMO}'s String Variable Space.  The
  1178. general form of a SET item is:
  1179.  
  1180.  
  1181.  
  1182.                                     -24-
  1183.  
  1184.      {set name,string}
  1185.  
  1186.           name
  1187.                Any valid variable name.
  1188.  
  1189.           string
  1190.                A text string to assign to the name.  The string may not
  1191.                contain any variables.
  1192.  
  1193. Any number of SET items may appear in the Setup File.  They may be used
  1194. later in macros, in telephone numbers, etc.
  1195.  
  1196. See Part II (MACRO.DOC) for more information on variables.
  1197.  
  1198.  
  1199. ----------  Explanation of Setup File Items
  1200.  
  1201. _________________________________________________
  1202.  
  1203. {ddp=38400,8n1,1,A,0}
  1204.     Default Dialing Parameters, set when you dial
  1205.     (speed,format,comport,terminal,delay).  These
  1206.     are also the current settings when you start
  1207.     the program.
  1208. _________________________________________________
  1209.  
  1210.      The values in this item will be used as the current settings when
  1211.      {COMMO} is started and each time dialing begins.  Use the "Terminal
  1212.      Parameters" item in the Dialing Directory to set overrides when
  1213.      required.  Use Alt-P or the macro function DPARms to change dialing
  1214.      parameters at other times.
  1215.  
  1216.      See "Set Terminal Parameters" for a complete description of each field
  1217.      and how to change current parameters as well.
  1218.  
  1219.      NOTE:  PCjr users without the internal modem should specify Com2.
  1220.  
  1221. _____________________________________
  1222.  
  1223. {com=1,3f8,4}   Com1 port address/IRQ
  1224. {com=2,2f8,3}   Com2 port address/IRQ
  1225. {com=3,3e8,4}   Com3 port address/IRQ
  1226. {com=4,2e8,3}   Com4 port address/IRQ
  1227. _____________________________________
  1228.  
  1229.      These are the hardware serial port base address and IRQ assignments. 
  1230.      The settings shown are the most common, but some serial adapters are
  1231.      different.  The serial adapter manual may give a range of addresses,
  1232.      for example "3f8-3ff."  Use the first value as the base address.
  1233.  
  1234.      Port addresses are in hexadecimal and may range from 0 to ffff.  IRQ
  1235.      numbers are decimal and may range from 0 to 15 (avoid use of IRQ
  1236.  
  1237.  
  1238.  
  1239.                                     -25-
  1240.  
  1241.      numbers that are used by system hardware, e.g., 0, 1, 8, etc.).  IRQ
  1242.      numbers from 8 to 15 are available only on AT class machines.
  1243.  
  1244.      The current serial port base address and IRQ number are available to
  1245.      macros in the built-in variables "_pad" and "_irq" respectively.
  1246.  
  1247.      NOTE:  If you need to define more than four ports, you can also use
  1248.      "com=5" through "com=8".  These latter four ports all default to
  1249.      3f8,4.
  1250.  
  1251. ______________________________________________________
  1252.  
  1253. {set _modini,~~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |~~}
  1254.     Modem Init String (2400 bps and higher)
  1255. ______________________________________________________
  1256.  
  1257.      This item defines the reserved variable "_modini" (notice that the
  1258.      string itself begins following the comma).
  1259.  
  1260.      The Modem Initialization String is normally sent to your modem when
  1261.      {COMMO} is started or when you press Alt-O.  
  1262.  
  1263.      If you are using a 1200 bps modem you should remove the "&C1 &D2"
  1264.      commands.  In either case the "X" command may have to be adjusted.
  1265.  
  1266.      See Appendix A "Setting Up Your Modem" for more information.
  1267.  
  1268. ___________________________________________
  1269.  
  1270. {min=yes}   Send Modem Init String (yes/no)
  1271. ___________________________________________
  1272.  
  1273.      If "yes" this will instruct {COMMO} to send the Modem Initialization
  1274.      String at program startup.  You can override this item with the "/iy"
  1275.      or "/in" command line switch.
  1276.  
  1277. _________________________________________________
  1278.  
  1279. {hfc=auto}
  1280.     Hardware (RTS/CTS) Flow Control (auto/yes/no)
  1281. {sfc=no}
  1282.     Software (XON/XOFF) Flow Control (yes/no)
  1283. _________________________________________________
  1284.  
  1285.      These are used to control the flow of data between your computer and
  1286.      the remote system.  They prevent loss of data when one end can send
  1287.      faster than the other end can process the information.
  1288.  
  1289.      The "auto" setting for Hardware Flow Control should be used in most
  1290.      cases.  {COMMO} will enable/disable Hardware Flow Control based on the
  1291.      state of the CTS (Clear To Send) signal.  The other settings should
  1292.      not be used unless you have an unusual hardware configuration.
  1293.  
  1294.  
  1295.  
  1296.                                     -26-
  1297.  
  1298.      Software Flow Control may be set to "yes" when {COMMO} is used with
  1299.      slower, non-buffered modems (e.g., 1200 or 2400 bps) or when required
  1300.      on some packet switching networks.  Note that this setting is also
  1301.      used during Zmodem file transfers.
  1302.  
  1303.           IMPORTANT!  Do not confuse this setting with XON/XOFF in your
  1304.           modem, which should be turned off for use with {COMMO}.
  1305.  
  1306.      See Appendix C for more information on flow control.
  1307.  
  1308. _____________________________________________________
  1309.  
  1310. {sld=no}   Stop serial input during disk I/O (yes/no)
  1311. _____________________________________________________
  1312.  
  1313.      This should be set to "yes" if your system drops characters when a
  1314.      disk (hard or floppy) is accessed.  The symptoms are:  missing
  1315.      characters in the Terminal Screen when capture is on, or excessive
  1316.      CRC/csum errors during internal protocol file transfers.
  1317.  
  1318.      This is equivalent to what some programs call "handshake slow."  In
  1319.      {COMMO} it works in conjunction with Hardware Flow Control (RTS/CTS),
  1320.      so both {COMMO} and your modem must have Hardware Flow Control
  1321.      engaged.
  1322.  
  1323.      If you use an external protocol program be sure to set the "handshake
  1324.      slow" parameter in that program as well.
  1325.  
  1326. ____________________________________________
  1327.  
  1328. {dex=no}   Drop DTR and RTS on exit (yes/no)
  1329. ____________________________________________
  1330.  
  1331.      Leave this "no" if you want to exit {COMMO} and return while still
  1332.      connected to a host.  "Yes" will normally cause the modem to hang up
  1333.      when exiting the program.
  1334.  
  1335. _______________________________________
  1336.  
  1337. {enq=no}   Answer ENQ with ACK (yes/no)
  1338. _______________________________________
  1339.  
  1340.      Some hosts send an ENQ control character (^E) periodically and require
  1341.      that the terminal "answer back" with an ACK (^F).  Set this item to
  1342.      "yes" only if your host requires this.
  1343.  
  1344.  
  1345.  
  1346.                                     -27-
  1347.  
  1348. ___________________________________________________
  1349.  
  1350. {ncr=nocar}   Macro to execute when carrier is lost
  1351. ___________________________________________________
  1352.  
  1353.      {COMMO} will execute the macro specified here when the Carrier Detect
  1354.      signal is lost.  This signal normally comes on when your modem
  1355.      connects with a host system, and goes off when the call is terminated.
  1356.  
  1357.      If a command window is on screen, the macro will activate when the
  1358.      window is exited.  If a macro is running when carrier is lost, the
  1359.      macro will be STOPped and the macro at the label will be started.
  1360.  
  1361.      {COMMO} will search for the label first in the auxiliary Macro File,
  1362.      then in the resident file.  If the label is not found, {COMMO} will
  1363.      continue as usual.
  1364.  
  1365.      TIPS on using the carrier lost macro:
  1366.  
  1367.       *   IMPORTANT!  This feature is enabled only when a connection is
  1368.           made using {COMMO}'s Auto Dialer.
  1369.  
  1370.       *   The macro label can be changed or cancelled using the NOCArrier
  1371.           macro function.  See Part II (MACRO.DOC) for details.
  1372.  
  1373.       *   Be sure that you have your modem configured to provide the
  1374.           carrier detect signal.  See Appendix A for modem information.
  1375.  
  1376. _______________________________________________
  1377.  
  1378. {aut=pzbr,^xB00}       Auto Receive, Zmodem DL
  1379. {aut=pzbs,^xB01}       Auto Receive, Zmodem UL
  1380. {aut=phbr,HS*^bR}      Auto Receive, HS/Link DL
  1381. {aut=phbr,HS*^bQ}      Auto Receive, HS/Link UL
  1382. _______________________________________________
  1383.  
  1384.      The general form for this item is:  {aut=label,string}.  When the
  1385.      specified string (up to 32 characters, case ignored) is received, the
  1386.      macro will be started.
  1387.  
  1388.      These are normally used for automatically starting downloads, but may
  1389.      be used to trigger any macro upon receiving any string.
  1390.  
  1391.      Up to 16 Auto Receive Strings may be specified.  Operates in Terminal
  1392.      Mode only (use SSLOok/CALOok/GOLOok/LOOKfor in macros).
  1393.  
  1394.      See "{COMMO} Auto Receive" and the AUTO macro function for more
  1395.      details.
  1396.  
  1397.  
  1398.  
  1399.                                     -28-
  1400.  
  1401. _______________________________________________
  1402.  
  1403. {rtr=}   Receive Translate Table initialization
  1404. {str=}   Send Translate Table initialization
  1405. _______________________________________________
  1406.  
  1407.      These items are used to place values into the character translation
  1408.      tables at program startup and, if desired, to turn translation ON. 
  1409.      Multiple receive or send items may be present.
  1410.  
  1411.      Character translation is used when you wish certain characters to be
  1412.      changed into other characters as they are received from, or as they
  1413.      are sent to, the remote system.  You may also cause received
  1414.      characters to be ignored.
  1415.  
  1416.      Examples:
  1417.  
  1418.           {rtr=y,7,0,36,156}
  1419.  
  1420.                Turn ON receive translation ("y").
  1421.  
  1422.                Change the bell character (ASCII 7) to null (ASCII 0, which
  1423.                will not display).
  1424.  
  1425.                Change the "$" (ASCII 36) to ASCII 156.
  1426.  
  1427.           {str=#26,97,65,42,43,#10,48,128}
  1428.  
  1429.                Change 26 consecutive values starting at 97 to consecutive
  1430.                values starting at 65.  This will change all lowercase
  1431.                letters (ASCII 97 to 122) to uppercase letters (ASCII 65 to
  1432.                90).
  1433.  
  1434.                Change the "*" (ASCII 42) to a "+" (ASCII 43).
  1435.  
  1436.                Change 10 consecutive values starting at 48 to consecutive
  1437.                values starting at 128.  This will change the digits 0
  1438.                through 9 (ASCII 48 to 57) to ASCII 128 to 137.
  1439.  
  1440.                The ON/OFF state of send translation will not be changed (no
  1441.                "y" or "n" is present).
  1442.  
  1443.      A "y", to turn translation ON, must be the first argument, if present. 
  1444.      It may be used on any "rtr" or "str" item and will apply to all 256
  1445.      values in either the receive table or the send table.  Note that
  1446.      translation defaults to OFF when {COMMO} is started.
  1447.  
  1448.      Use a PAIR of arguments to change a single value.
  1449.  
  1450.      Use THREE arguments to change a range of consecutive values to another
  1451.      range of consecutive values.  The "#" operator on the first argument
  1452.      specifies the number of values to change, followed by the starting
  1453.      values for each range.
  1454.  
  1455.  
  1456.  
  1457.                                     -29-
  1458.  
  1459.  
  1460.      Changing any character to ASCII 0 (null) will cause the character to
  1461.      be ignored in most situations.  For example, it will not display, will
  1462.      not appear in a Capture File (unless RAW mode is used) and will be
  1463.      ignored by macro functions such as LOOKfor and GETString.
  1464.  
  1465.      The macro functions RTRAn and STRAn have similar argument lists.  In
  1466.      addition they allow you to restore each Translate Table to default
  1467.      values and to turn translation ON and OFF without disturbing the
  1468.      values in the tables.  See Part II (MACRO.DOC) for more details.
  1469.  
  1470. _____________________________________________________
  1471.  
  1472. {cdm=yes}   Clear dialing marks when loading (yes/no)
  1473. _____________________________________________________
  1474.  
  1475.      If this is "yes", {COMMO} will clear all dialing marks when loading a
  1476.      Dialing Directory file.  This applies at program startup and whenever
  1477.      a file is loaded during a session.  Note that the marks are saved with
  1478.      a file when it is written to disk.
  1479.  
  1480.      Set this item to "no" if you want to retain the dialing marks.
  1481.  
  1482. ____________________________________________
  1483.  
  1484. {set _dialpf,ATDT }   Default Dialing Prefix
  1485. {set _dialsf, |}      Default Dialing Suffix
  1486. ____________________________________________
  1487.  
  1488.      These reserved variables define strings that will be used to create
  1489.      the modem dialing command.  The prefix, telephone number and suffix
  1490.      will be strung together in that order and sent to your modem when you
  1491.      dial.
  1492.  
  1493.      Any number of additional prefixes and suffixes may be used by
  1494.      including variables in the telephone number string (see "[Alt-D] 
  1495.      Dialing Directory" for details).
  1496.  
  1497.      Use "ATDP" if you don't have a tone line.  Use "ATDT9," to get an
  1498.      outside line on a switchboard.  The suffix is usually just a carriage
  1499.      return (|).  Your modem manual has additional tips on dialing prefixes
  1500.      and suffixes.
  1501.  
  1502. ___________________________________________
  1503.  
  1504. {dct=45}   Dialing cycle time-out (seconds)
  1505. ___________________________________________
  1506.  
  1507.      The maximum time to wait before hanging up and redialing.  Adjust if
  1508.      your modem needs more time to complete a call.
  1509.  
  1510.  
  1511.  
  1512.                                     -30-
  1513.  
  1514. __________________________________________________
  1515.  
  1516. {idt=2}   Delay between dialing attempts (seconds)
  1517. __________________________________________________
  1518.  
  1519.      Amount of time to wait between dialing attempts.  Adjust to give
  1520.      incoming calls a greater chance of getting through.
  1521.  
  1522. ______________________________________________
  1523.  
  1524. {dcn=c}   Method to cancel dialing (c/d/s,...)
  1525. ______________________________________________
  1526.  
  1527.      This item defines the method that {COMMO} will use to cancel a dialing
  1528.      attempt in progress.  Dialing is cancelled when you press Esc or when
  1529.      {COMMO} times out.  Options are:
  1530.  
  1531.           c    Send a carriage return
  1532.           d    Drop DTR
  1533.           s    Send a user-defined string
  1534.  
  1535.      The "s" option lets you define your own string.  The string can be up
  1536.      to 8 characters in length, including any carets or tildes (see
  1537.      Appendix D).  Here's an example that sends a Ctrl-X, followed by a
  1538.      half-second delay and a carriage return:
  1539.  
  1540.           {dcn=s,^x~|}       Fictitious example
  1541.  
  1542. _________________________________________
  1543.  
  1544. {set _dialsr,CARRIER ,CONNECT}
  1545.     Dialing success response(s)
  1546. {set _dialfr,BUSY,NO CARRIER,NO DIALTONE}
  1547.     Dialing failure response(s) 
  1548. {set _dialir,RING}
  1549.     Inter-dial response(s)           
  1550. _________________________________________
  1551.  
  1552.      These reserved variables each define a list of response strings that
  1553.      are returned by your modem during dialing operations.  Most "Hayes
  1554.      compatible" modems use similar responses, but there may be subtle
  1555.      differences.  Consult your modem manual for details.
  1556.  
  1557.      "Success" responses are received when the modem has connected with a
  1558.      remote modem.  "Failure" responses occur when the number being called
  1559.      is busy, doesn't answer or when something is wrong with the telephone
  1560.      line.  {COMMO} will automatically redial the number after a failed
  1561.      attempt.
  1562.  
  1563.      Inter-dial Delay responses may occur during the delay between dialing
  1564.      attempts, usually when someone is trying to call you.  These may be
  1565.      handled by using the Inter-dial Delay macro label in the DIAL macro
  1566.      function.  See Part II (MACRO.DOC) for details.
  1567.  
  1568.  
  1569.  
  1570.                                     -31-
  1571.  
  1572.  
  1573.      Some modems use a CARRIER response to indicate the modem speed, e.g.
  1574.      CARRIER 14400.  In this case using CARRIER instead of CONNECT will
  1575.      improve the accuracy of the Usage Log.  In order to avoid confusion
  1576.      with a NO CARRIER response, you should use:
  1577.  
  1578.           {set _dialsr,CARRIER }   [Notice the space after "CARRIER"]
  1579.  
  1580.      Responses are case sensitive and there should be no null strings or
  1581.      extra spaces.
  1582.  
  1583. ___________________________________________________________
  1584.  
  1585. {set zr_mode,r}   Zmodem like-named file mode (s/r/n/o)
  1586.                     s=skip, r=resume, n=rename, o=overwrite
  1587. ___________________________________________________________
  1588.  
  1589.      This variable tells {COMMO} what to do when a file being received with
  1590.      Zmodem already exists in your download directory.  See "[PgUp]/[PgDn] 
  1591.      Uploading/Downloading" for details.
  1592.  
  1593.      NOTE:  This variable can be changed at any time by pressing "M" in the
  1594.      Download Protocol Menu.
  1595.  
  1596. _________________________________________________________
  1597.  
  1598. {set protodir,c:\commo}   Path to find external protocols
  1599. _________________________________________________________
  1600.  
  1601.      This is the path where you keep your external protocol programs.  Copy
  1602.      the executable programs, HSLINK.EXE and OZBEXT.EXE, into this
  1603.      directory and {COMMO} will know where to find them.  Do not use a "\"
  1604.      at the end of the path.
  1605.  
  1606. ______________________________________________
  1607.  
  1608. {set uldir,c:\commo}   Path to find uploads
  1609. {set dldir,c:\commo}   Path to place downloads
  1610. ______________________________________________
  1611.  
  1612.      These variables are used in some of the macros in COMMO.MAC and
  1613.      SAMPLES.MAC, primarily in the Uploading and Downloading macros.  They
  1614.      are not reserved variables, so you may change their names if you
  1615.      change the macros.  Do not use a "\" at the end of the paths.
  1616.  
  1617.  
  1618.  
  1619.                                     -32-
  1620.  
  1621. ________________________________
  1622.  
  1623. {set _uselog,c:\commo\commo.log}
  1624.     Path\filename for Usage Log
  1625. ________________________________
  1626.  
  1627.      This is a reserved variable that tells {COMMO} where to find your
  1628.      Usage Log.  The Usage Log keeps a record of the calls you make.  If a
  1629.      valid path\filename is specified, entries will be made when:
  1630.  
  1631.           1) You connect to a system.
  1632.           2) You transfer a file using an internal protocol.
  1633.           3) You disconnect (or exit {COMMO}).
  1634.           4) The macro function OFFLog executes.
  1635.  
  1636.      IMPORTANT!  In order for the log to function properly your modem must
  1637.      be set to provide "true carrier detect" (see Appendix A).  The macro
  1638.      function OFFLog is provided for situations where this is not possible.
  1639.  
  1640.      Use a null path\filename or remove this item to disable the Usage Log. 
  1641.      A null path\filename would look like this:
  1642.  
  1643.           {set _uselog}
  1644.  
  1645.      The Usage Log should be disabled when you are connecting directly to
  1646.      another computer (with a null modem cable).
  1647.  
  1648.      If you specify the same log file as used by an external protocol
  1649.      program, you will have a complete record of your calls, including
  1650.      upload/download statistics.
  1651.  
  1652.      If a filename only (no path) is specified, the current directory will
  1653.      be used.  The path\filename of an open Capture File is not allowed.
  1654.  
  1655.      See also Appendix F "Usage Log Format."
  1656.  
  1657. __________________________________
  1658.  
  1659. {cap=c:\commo\commo.cap}
  1660.     Path\filename for Capture File
  1661. __________________________________
  1662.  
  1663.      This is the initial setting for the Capture File path\filename.  It
  1664.      may be changed later with the Alt-1 key command or with the CAPTure
  1665.      macro function (do not try to change the "_cap" built-in variable with
  1666.      SETV).
  1667.  
  1668.      If a filename only (no path) is specified, the current directory will
  1669.      be used.
  1670.  
  1671.      See also "[Alt-1]  Capture File Options."
  1672.  
  1673.  
  1674.  
  1675.                                     -33-
  1676.  
  1677. _______________________________________
  1678.  
  1679. {scr=c:\commo\commo.scr}
  1680.     Path\filename for Screen Image File
  1681. _______________________________________
  1682.  
  1683.      This is the initial setting for the Screen Image File path\filename. 
  1684.      It may be changed later with the Alt-I key command, with the SCREen
  1685.      macro function, or from within the Scrollback Buffer window (do not
  1686.      try to change the "_scr" built-in variable with SETV).
  1687.  
  1688.      If a filename only (no path) is specified, the current directory will
  1689.      be used.  The path\filename of an open Capture File is not allowed.
  1690.  
  1691.      See also "[Alt-I]  Screen Image Save" and "[Alt-K]  Scrollback"
  1692.  
  1693. ____________________________________________
  1694.  
  1695. {swp=}   Path\filename for Swap to Disk File
  1696. ____________________________________________
  1697.  
  1698.      You can free up most of the memory occupied by {COMMO} when you use
  1699.      the Shell to DOS key command or the EXECute macro function.  The file
  1700.      specified in this item will be used to save the program and data
  1701.      during a Swap to Disk.
  1702.  
  1703.      IMPORTANT!  You must also specify the "S" switch on any EXECute or
  1704.      SHELl macro functions where swapping is desired.
  1705.  
  1706.      A unique filename not likely to be used by other applications should
  1707.      be specified.  For example:
  1708.  
  1709.           {swp=c:\commo\swap$$$.1}
  1710.  
  1711.      NOTE:  If the file already exists, {COMMO} will attempt to modify the
  1712.      name by changing the last character to an "A", then to a "B", etc.  
  1713.  
  1714.      Before using this feature, read "[Alt-S]  Shell to DOS" and see also
  1715.      the EXECute and SHELl macro functions in Part II (MACRO.DOC).
  1716.  
  1717. _______________________________________________
  1718.  
  1719. {set _exted}   Command line for external editor
  1720. _______________________________________________
  1721.  
  1722.      An external editor may be defined to edit the Dialing Directory and
  1723.      Macro Files directly from their respective windows.  See Appendix K
  1724.      for details.
  1725.  
  1726.  
  1727.  
  1728.                                     -34-
  1729.  
  1730. _____________________________________________
  1731.  
  1732. {ebl=yes}   Expand blank lines (yes/no)
  1733. {slf=yes}   Strip outgoing linefeeds (yes/no)
  1734. {pac=}      ASCII Upload pacing character
  1735. _____________________________________________
  1736.  
  1737.      These items are used with the ASCII Upload feature.
  1738.  
  1739.      Blank line expansion sends a space and a carriage return, instead of
  1740.      just a carriage return for lines with no data.  This prevents BBS line
  1741.      editors from terminating prematurely.
  1742.  
  1743.      Stripping linefeeds gives the data the appearance of being entered
  1744.      manually.  Linefeeds should not be stripped when the remote is not in
  1745.      "edit" mode.
  1746.  
  1747.      The pacing character shown is null (no pacing).  To use a ":" for
  1748.      pacing, change the item to
  1749.  
  1750.           {pac=:}
  1751.  
  1752.      See "[Alt-A]  ASCII Upload" for more details.
  1753.  
  1754. ____________________________
  1755.  
  1756. {mac=}   Startup macro label
  1757. ____________________________
  1758.  
  1759.      This item indicates a macro (in the resident Macro File) to run when
  1760.      {COMMO} starts up.  The command line switch "/:" can be used to
  1761.      override it.  See "Command Line Options."
  1762.  
  1763.      Example:  {mac=begin}
  1764.  
  1765. __________________________________________________
  1766.  
  1767. {esf=8}   Edit space for files in kilobytes (0-64)
  1768. __________________________________________________
  1769.  
  1770.      This is the amount of expansion memory {COMMO} will allocate for each
  1771.      file that can be edited with the Internal Editor.  When the expansion
  1772.      space is used up, the file may be reloaded to obtain more.  See
  1773.      Appendix K for details on {COMMO} support files.
  1774.  
  1775. ___________________________________________
  1776.  
  1777. {edd=no}   Enter Dialing Directory (yes/no)
  1778. ___________________________________________
  1779.  
  1780.      If this is set to "yes" the Dialing Directory will be entered when
  1781.      {COMMO} is started (if no Dialing Strings or Startup Macro are present
  1782.      on the command line).
  1783.  
  1784.  
  1785.  
  1786.                                     -35-
  1787.  
  1788.  
  1789. _________________________________
  1790.  
  1791. {loc=no}   Local Echo on (yes/no)
  1792. _________________________________
  1793.  
  1794.      If this is set to "yes" Local Echo will be on when {COMMO} is started. 
  1795.      See also "[Alt-T]  Set Toggles."
  1796.  
  1797. ____________________________________
  1798.  
  1799. {sig=no}   Signal Lights on (yes/no)
  1800. ____________________________________
  1801.  
  1802.      If this is set to "yes" Signal Lights will be on when {COMMO} is
  1803.      started.
  1804.  
  1805. _____________________________________
  1806.  
  1807. {cpf=no}   Capture File open (yes/no)
  1808. _____________________________________
  1809.  
  1810.      If this is set to "yes" Capture will be open when {COMMO} is started. 
  1811.      See "[Alt-1]  Capture File Options."
  1812.  
  1813. _______________________________________________
  1814.  
  1815. {cpm=screen}   Capture Mode (screen/filter/raw)
  1816. _______________________________________________
  1817.  
  1818.      See "[Alt-1]  Capture File Options" for a description of each mode.
  1819.  
  1820. _______________________________________________
  1821.  
  1822. {tek=yes}   Test for enhanced keyboard (yes/no)
  1823. _______________________________________________
  1824.  
  1825.      Set this to "no" only if your system (BIOS) does not support the
  1826.      enhanced (101 key) keyboard.  Normally this applies only to older, XT
  1827.      class machines.
  1828.  
  1829. __________________________________________________
  1830.  
  1831. {dmk=8300}
  1832.     Scan code for Doorway Mode key (see COMMO.DOC)
  1833. __________________________________________________
  1834.  
  1835.      This item defines the key used to enter and exit Doorway Mode.  The
  1836.      default key is Alt-=.  The scan code (such as "8300") is obtained by
  1837.      pressing Alt-K in {COMMO}'s Internal Editor, then pressing the key you
  1838.      wish to use.
  1839.  
  1840.  
  1841.  
  1842.                                     -36-
  1843.  
  1844.      Note that a corresponding macro must exist in the Macro File.  The
  1845.      macro (provided in COMMO.MAC) to use with Alt-= is:
  1846.  
  1847.           {:al=} {doorway} {}
  1848.  
  1849.      If you change the key definition in COMMO.SET, be sure to change the
  1850.      key-label in COMMO.MAC.
  1851.  
  1852. _____________________________________
  1853.  
  1854. {mky=}   User-defined macro key-label
  1855. _____________________________________
  1856.  
  1857.      (Note that this feature is unavailable during shareware evaluation.)
  1858.  
  1859.      This item allows you to assign a macro key-label to almost any key or
  1860.      key combination on your keyboard.  Up to 32 "mky" items may be used
  1861.      (any more will be ignored).  Here are some examples:
  1862.  
  1863.           {mky=cta,1e01}     Ctrl-A
  1864.           {mky=bsh,2b5c}     Backslash
  1865.  
  1866.      Any valid, three character label may be used as a user-defined key-
  1867.      label (such as "cta" in the example).  The scan code (such as "1e01")
  1868.      is obtained by pressing Alt-K in {COMMO}'s Internal Editor, then
  1869.      pressing the key you wish to use.
  1870.  
  1871.      For additional information and certain restrictions, see Appendix H
  1872.      "{COMMO} Macro Key-labels."
  1873.  
  1874. ________________________________________________
  1875.  
  1876. {set sel_up,no}
  1877.     Go directly to picklist for uploads (yes/no)
  1878. ________________________________________________
  1879.  
  1880.      Set this item to "yes" and {COMMO} will skip the input prompt for a
  1881.      filename.  Instead you will see the file picklist immediately.  Note
  1882.      that you can also type in filenames from the picklist window -- handy
  1883.      if you need to type in multiple filenames for batch uploading.
  1884.  
  1885. _____________________________________________
  1886.  
  1887. {set sel_pns,no}
  1888.     Use COMMOPNS for upload picklist (yes/no)
  1889. _____________________________________________
  1890.  
  1891.      COMMOPNS is a shareware program that lets you tag files for uploading. 
  1892.      It operates faster and displays more files at one time than {COMMO}'s
  1893.      file selector macro.  Set this item to "yes" after installing
  1894.      COMMOPNS.EXE in your "protodir" directory.
  1895.  
  1896.      IMPORTANT!  Do not use the macros supplied with COMMOPNS.
  1897.  
  1898.  
  1899.  
  1900.                                     -37-
  1901.  
  1902.  
  1903.      The archive PNS52.ZIP is supplied on the {COMMO} registration disk. 
  1904.      It may also be found on many fine BBS's.
  1905.  
  1906. _________________________________________________________
  1907.  
  1908. {tsn=yes}   Display time of day with System Name (yes/no)
  1909. _________________________________________________________
  1910.  
  1911.      If this is "yes" the time of day will be displayed on the right side
  1912.      of the Status Line.  Set this to "no" if you want the System Name to
  1913.      have more space.  Note that the time is always shown when the Signal
  1914.      Lights are displayed.
  1915.  
  1916. ___________________________________________________
  1917.  
  1918. {dat=mdy}
  1919.     Order of date parameters (m=month,d=day,y=year)
  1920. ___________________________________________________
  1921.  
  1922.      This item allows you to specify any order for the three date
  1923.      parameters.  The default shown would display May 20, 1992 as 05/20/94. 
  1924.      "ymd" would display as 94/05/20.
  1925.  
  1926.      This format will appear in the Date Last Called field of the Dialing
  1927.      Directory, the Usage Log and the built-in variable "_dat".
  1928.  
  1929. ___________________________________
  1930.  
  1931. {tim=12}   Time format (12/24 hour)
  1932. ___________________________________
  1933.  
  1934.      You can specify 12 or 24 hour time format.  12 hour will add "am" or
  1935.      "pm" as in "2:30 pm".  24 hour would show the same time as "14:30".
  1936.  
  1937.      The time format appears on the Status Line, in the Usage Log and in
  1938.      the built-in variable "_tim".
  1939.  
  1940. ____________________________________
  1941.  
  1942. {snd=yes}   Master Sound on (yes/no)
  1943. ____________________________________
  1944.  
  1945.      If this is set to "yes" sound will be on when {COMMO} is started.  If
  1946.      "no" all sounds will be silenced.
  1947.  
  1948.  
  1949.  
  1950.                                     -38-
  1951.  
  1952. _____________________________________________
  1953.  
  1954. {dca=yes}   Dialing connection alarm (yes/no)
  1955. _____________________________________________
  1956.  
  1957.      Controls the alarm that signals a connection when Auto Dialing is
  1958.      used.  Note that the alarm will not be sounded when a valid Linked
  1959.      Macro is specified in the Dialing Directory.
  1960.  
  1961. ________________________________________________
  1962.  
  1963. {afa=yes}   ASCII Upload finished alarm (yes/no)
  1964. ________________________________________________
  1965.  
  1966.      Controls the alarm that signals completion of an ASCII Upload.
  1967.  
  1968. ___________________________________________________
  1969.  
  1970. {ers=yes}   Make sounds on errors/warnings (yes/no)
  1971. ___________________________________________________
  1972.  
  1973.      This controls the special sounds made for certain errors and warning
  1974.      messages.
  1975.  
  1976. _______________________________________________
  1977.  
  1978. {rng=3}   Maximum number of alarm rings (1-999)
  1979. _______________________________________________
  1980.  
  1981.      Sets the number of times the alarm will ring.  You may press a key at
  1982.      any time to stop the alarm.
  1983.  
  1984. _____________________________________________
  1985.  
  1986. {sfi=no}   Speech Friendly Interface (yes/no) 
  1987. _____________________________________________
  1988.  
  1989.      If this is "yes" {COMMO} will be much friendlier to users with speech
  1990.      synthesizer systems (these enable blind users to read the computer
  1991.      display).  Major differences are:
  1992.  
  1993.       *   Terminal Screen data, input fields and many information and error
  1994.           messages will be displayed using the BIOS.
  1995.  
  1996.       *   The up and down arrow keys move the cursor instead of scrolling
  1997.           the screen in windows such as Online Help, Scrollback and View
  1998.           String Variable Space.  This is similar to being in a text
  1999.           editor, where the data is read by moving the cursor.
  2000.  
  2001.       *   In the Dialing Directory window, {COMMO} will make distinctive
  2002.           sounds when entries are marked or unmarked for dialing.  The [T]
  2003.           and [R] keys will mark and unmark entries without moving the
  2004.  
  2005.  
  2006.  
  2007.                                     -39-
  2008.  
  2009.           Selector Bar.  If the entry is already in the desired state, a
  2010.           special sound will be made.
  2011.  
  2012.       *   Distinctive sounds will be made when opening or closing a Capture
  2013.           File with the Alt-1 key command.
  2014.  
  2015.      You can use the macro function SFICtrl to toggle this feature on/off
  2016.      during program operation.  You can also test the current state with
  2017.      the "_sfi" built-in variable.  See Part II (MACRO.DOC) and Appendix I
  2018.      for details.
  2019.  
  2020. _____________________________________________________
  2021.  
  2022. {sbs=10}   Scrollback buffer size in kilobytes (0-64)
  2023. _____________________________________________________
  2024.  
  2025.      The actual minimum size of the buffer (which {COMMO} will compute)
  2026.      depends on the number of screen lines and columns.  For a 25x80 screen
  2027.      it will be about 4k bytes -- it will be larger for screens with more
  2028.      lines and/or columns.
  2029.  
  2030.      Setting the size to 0 disables the Scrollback feature.  See also
  2031.      "[Alt-K]  Scrollback."
  2032.  
  2033. ___________________________________
  2034.  
  2035. {sts=yes}   Status Line on (yes/no)
  2036. ___________________________________
  2037.  
  2038.      If this is set to "yes" the Status Line will be on when {COMMO} is
  2039.      started.
  2040.  
  2041. _________________________________________________
  2042.  
  2043. {slt=yes}   Status Line at top of screen (yes/no)
  2044. _________________________________________________
  2045.  
  2046.      If this is "yes" the Status Line will appear at the top of the
  2047.      Terminal Screen.  Otherwise it will be at the bottom.
  2048.  
  2049. ___________________________________________________
  2050.  
  2051. {adn=yes}
  2052.     Auto-detect number of rows and columns (yes/no)
  2053. ___________________________________________________
  2054.  
  2055.      Set this item to "yes" if you want {COMMO} to automatically obtain the
  2056.      current number of rows and columns from the system at program startup
  2057.      (most systems provide this information).  If the display is
  2058.      unsatisfactory, you may have to set this to "no."
  2059.  
  2060.      {COMMO} will support 25 to 127 rows and 80 to 255 columns.  Note that
  2061.      the display must be in the proper mode before starting the program
  2062.  
  2063.  
  2064.  
  2065.                                     -40-
  2066.  
  2067.      (EGA/VGA adapters usually come with utilities to set modes such as
  2068.      50x80, 44x132, etc.).  You may also define an alternate video mode and
  2069.      switch to it after starting the program (see next item).
  2070.  
  2071.      NOTE:  The cursor may not display properly in 43 line mode.  This is a
  2072.      problem with some EGA adapters.
  2073.  
  2074. ______________________________________________
  2075.  
  2076. {avm=}   Alternate video mode (mode,rows,cols)
  2077. ______________________________________________
  2078.  
  2079.      You can toggle between two video modes (text modes only) if this item
  2080.      is defined.  One important application for this is the 132 column
  2081.      feature in VT102 emulation.  It can also be used to toggle between any
  2082.      two different video modes using the VIDEo macro function.
  2083.  
  2084.      The "normal" video mode is the mode that is in effect when {COMMO} is
  2085.      started.  That mode will always be restored automatically when you
  2086.      exit the program.  If you Shell to DOS or use the EXECute macro
  2087.      function, the current mode will remain in effect.
  2088.  
  2089.      The mode field must be expressed as a hexadecimal number, while the
  2090.      rows and columns are decimal numbers (minimum dimensions are 25x80). 
  2091.      As an example, suppose that your video adapter uses mode 23h
  2092.      (hexadecimal) to support a 25x132 screen.  Then you would write this
  2093.      item as:
  2094.  
  2095.           {avm=23,25,132}     Alternate video mode
  2096.  
  2097.      Set mode "3" to use the standard 50 line mode supported by VGA
  2098.      adapters or the standard 43 line mode supported by EGA adapters.  For
  2099.      example:
  2100.  
  2101.           {avm=3,50,80}     Alternate video mode
  2102.  
  2103.      The following macro will restore the "normal" mode when Shelling to
  2104.      DOS and bring back the alternate mode upon return (press Alt-S to
  2105.      activate):
  2106.  
  2107.           {:als} {video-m0} {shell} {video-m1} {}
  2108.  
  2109.      Note that some screen "modes" are not hardware modes and cannot be
  2110.      toggled using this feature.  Consult your video adapter manual for a
  2111.      list of hardware modes supported (or contact the manufacturer).
  2112.  
  2113.  
  2114.  
  2115.                                     -41-
  2116.  
  2117. __________________________________________________
  2118.  
  2119. {edi=yes}   Startup editor in insert mode (yes/no)
  2120. __________________________________________________
  2121.  
  2122.      Set this to "yes" if you want insert mode turned on the first time you
  2123.      start the Internal Editor.  This also applies to the input field
  2124.      editor.
  2125.  
  2126. ____________________________________________________
  2127.  
  2128. {ucw=18}   Number of lines in upper Chat Mode window
  2129. ____________________________________________________
  2130.  
  2131.      This allows you to adjust the line "split" in Chat Mode.  The minimum
  2132.      number of lines in the upper or lower window is three.
  2133.  
  2134. ____________________________________________________
  2135.  
  2136. {swe=no}
  2137.     Send when Enter is pressed in Chat Mode (yes/no)
  2138. ____________________________________________________
  2139.  
  2140.      If "no" {COMMO} will send each character as you type it.  If "yes"
  2141.      {COMMO} will wait until you press Enter, then send all that you have
  2142.      typed.
  2143.  
  2144. ___________________________________________________
  2145.  
  2146. {bsc=no}
  2147.     Use BIOS for Terminal Screen scrolling (yes/no)
  2148. {sno=no}
  2149.     Snow checking on CGA adapter (yes/no)
  2150. ___________________________________________________
  2151.  
  2152.      Change these video parameters only if necessary.
  2153.  
  2154.       *   BIOS scrolling enables external scrollback programs to work, but
  2155.           is slower and may cause "flicker" in certain displays.
  2156.  
  2157.       *   Snow checking will also slow the display, but will help to
  2158.           eliminate the "snow" effect on CGA monitors.
  2159.  
  2160. ___________________________________
  2161.  
  2162. {gdc=}   Graphic display characters
  2163. ___________________________________
  2164.  
  2165.      This item allows you to specify the graphic characters used by {COMMO}
  2166.      to form the various display windows and is provided for compatibility
  2167.      with display adapters used in certain countries.
  2168.  
  2169.  
  2170.  
  2171.                                     -42-
  2172.  
  2173.      When using this item, twelve ASCII character codes may be listed
  2174.      (omitted fields will revert to the defaults).  Codes are specified as
  2175.      decimal numbers from 1 to 255 (0, 10 and 13 are not allowed).
  2176.  
  2177.      As an example, here is how the default characters would be listed:
  2178.  
  2179.           {gdc=213,184,212,190,205,179,185,204,176,250,177,178}
  2180.  
  2181.      where:
  2182.  
  2183.                213 = upper left box corner
  2184.                184 = upper right box corner
  2185.                212 = lower left box corner
  2186.                190 = lower right box corner
  2187.                205 = horizontal line
  2188.                179 = vertical line
  2189.                185 = left side of box title
  2190.                204 = right side of box title
  2191.                176 = file window title fill
  2192.                250 = various fills (dots)
  2193.                177 = Online Help separator bar
  2194.                178 = protocol progress bar
  2195.  
  2196. _________________________________________
  2197.  
  2198. {clm=auto}   Color Mode (auto/color/mono)
  2199. _________________________________________
  2200.  
  2201.      If this item is set to "auto," {COMMO} will auto detect the display
  2202.      type and use the proper mode.  The default modes are "color" for color
  2203.      displays and "mono" for monochrome displays.
  2204.  
  2205.      If you have a laptop with a black and white LCD display (VGA, EGA or
  2206.      CGA compatible), you can use the "mono" mode to improve the contrast
  2207.      (color items below will be ignored).
  2208.  
  2209.      Setting the mode to "color" will force the use of the
  2210.      colors/attributes in the items below.  This is useful if you have a
  2211.      monochrome display and you prefer to set your own attributes.
  2212.  
  2213.      Press F7 while editing the Setup File (or other files) to pop up the
  2214.      color chart.  You may use it with color or monochrome displays.  Color
  2215.      settings have no effect when the Color Mode is "mono" (or "auto" with
  2216.      a monochrome display).
  2217.  
  2218.      Colors may range from 0-9,A-F.  Background colors from 8-F will cause
  2219.      blinking unless bright background colors are enabled in the video
  2220.      hardware.
  2221.  
  2222.      NOTE:  Terminal Screen colors/attributes may still be changed if ANSI
  2223.      display data is received from the host.  It may be necessary to adjust
  2224.      your settings at the host.
  2225.  
  2226.  
  2227.  
  2228.                                     -43-
  2229.  
  2230. _________________________________________________
  2231.  
  2232. {kts=07,17}   Terminal Screen, Status Line colors
  2233. _________________________________________________
  2234.  
  2235.      For the most accurate ANSI-BBS or VT102 terminal emulation, the
  2236.      Terminal Screen colors should be set to 07.  In many cases, {COMMO}
  2237.      uses this color when clearing portions of the screen or when a "reset
  2238.      attributes" sequence is received from the host.
  2239.  
  2240. ___________________________________________________
  2241.  
  2242. {kdd=1e,70,4f}   Dialing Directory window colors
  2243. {kmf=1e,70,4f}   Macro File window colors
  2244. {kaf=1f,70,4f}   Auxiliary Macro File window colors
  2245. {ksb=03,70,4f}   Scrollback window colors
  2246. {khf=1e,70,4f}   Online Help file window colors
  2247. {kes=1e,70,4f}   Edit Setup File window colors
  2248. {kee=1f,70,4f}   Edit external file window colors
  2249. {kvs=1e,70,4f}   Variable Space window colors
  2250. ___________________________________________________
  2251.  
  2252.      These are the "file" window colors.  The three parameters are the
  2253.      text, titles and highlight colors, respectively.  The highlight colors
  2254.      are used for the Selector Bar (when applicable) and for inputs and
  2255.      messages on the bottom line.
  2256.  
  2257. ________________________________________________________
  2258.  
  2259. {kcf=70,17}           Capture File Options window colors
  2260. {ksi=70,17}           Screen Image file window colors
  2261. {kdw=03,47}           Dialer window colors
  2262. {kau=70,17}           ASCII Upload window colors
  2263. {kpw=70,17}           Protocol window colors
  2264. {kid=70,17}           Input data window colors
  2265. {kst=70,17}           Set Toggles window colors
  2266. {ktp=70,17}           Terminal Parameters window colors
  2267. {kep=70,17}           Execute Preview window colors
  2268. {kmw=4f,6f}           Message window colors
  2269. {set menu_clr,70,17}  Macro Menu colors
  2270. ________________________________________________________
  2271.  
  2272.      These are the "pop-up" window colors.  The two parameters are the text
  2273.      and border, respectively.  The "Macro Menu" colors are used by some of
  2274.      the standard menus in COMMO.MAC.  To set colors for individual menus,
  2275.      set the "_mcolor" variable just prior to executing the MENU function.
  2276.  
  2277.  
  2278.      Colors should be set so that the different parts of the screen
  2279.      contrast with each other.  For example the Status Line should be
  2280.      easily discernable from the rest of the Terminal Screen.  And the
  2281.      borders and highlights should stand out against the text portion of
  2282.      the file windows.
  2283.  
  2284.  
  2285.  
  2286.                                     -44-
  2287.  
  2288.  
  2289.  
  2290. -----=====  [Alt-H]  Hang Up
  2291.  
  2292. Disconnects the call by dropping DTR.  This will put the modem "on-hook" if
  2293. response to DTR is enabled (see Appendix A).  If your modem does not
  2294. respond properly, you may define a macro to send a "hang-up" command.  For
  2295. modems using the "AT" command set the macro would look like this:
  2296.  
  2297.      {:alh} {send ~~~+++~~~ATH|} {}    Press Alt-H to hangup
  2298.  
  2299. This macro will run when Alt-H is pressed, but you may assign any key you
  2300. like.
  2301.  
  2302.  
  2303. -----=====  [Alt-I]  Screen Image Save
  2304.  
  2305. The Screen Image Save is used to append all of the text currently on the
  2306. screen to a disk file.  This is sometimes handier than repeatedly opening
  2307. and closing the Capture File.
  2308.  
  2309. TIPS on using Screen Image Save:
  2310.  
  2311.  *   Set the filename to "PRN", "LPT1" or "LPT2" to print the screen.
  2312.  
  2313.  *   If the file cannot be opened, the old path\filename is retained.
  2314.  
  2315.  *   The path\filename may not be the same as the path\filename of an open
  2316.      Capture File.
  2317.  
  2318. NOTE:  The current Screen Image Save file is also used to save blocks of
  2319. text in the Scrollback feature.
  2320.  
  2321. See also "[Alt-1]  Capture File Options" and "[Alt-K]  Scrollback."
  2322.  
  2323.  
  2324. -----=====  [Alt-K]  Scrollback
  2325.  
  2326. Scrollback allows you to see what was previously on your screen.  Screen
  2327. data is saved to a memory buffer (the size is defined in the Setup File). 
  2328. Set the size to 0 to disable the feature entirely.
  2329.  
  2330. A number of commands are available in Scrollback (keys to press are shown
  2331. in Online Help):
  2332.  
  2333. 1)   You may navigate as in the Online Help file -- scroll up/down, scroll
  2334.      left/right, page up/down, beginning/end of buffer, etc.
  2335.  
  2336. 2)   Use the String Search feature available in all {COMMO} file windows.
  2337.  
  2338. 3)   Write any part of the Scrollback buffer to the current Screen Image
  2339.      Save file.
  2340.  
  2341.  
  2342.  
  2343.                                     -45-
  2344.  
  2345. 4)   Change the Screen Image Save path\filename.
  2346.  
  2347. 5)   Exit and return to the same place the next time you call Scrollback.
  2348.  
  2349. 6)   Jump directly to the Dialing Directory or Macro File windows.
  2350.  
  2351.  
  2352. -----=====  [Alt-M]  Macro File
  2353.  
  2354. The Macro File window displays {COMMO} Macro Files which are currently in
  2355. memory -- resident and auxiliary.  Resident macros are loaded at program
  2356. startup (the default resident file is COMMO.MAC).
  2357.  
  2358. An auxiliary Macro File can be loaded, replaced or unloaded at any time
  2359. using the CALL, GOTO and UNLOad macro functions.  An auxiliary can also be
  2360. loaded manually within the window.  See Appendix K "{COMMO} Support Files"
  2361. for more details on Macro Files.
  2362.  
  2363. Within the Macro File window, macros from either the resident or auxiliary
  2364. Macro Files may be selected for execution or edited (using the Internal
  2365. Editor).
  2366.  
  2367. IMPORTANT!  Only macros currently in memory can execute.
  2368.  
  2369. Part II (MACRO.DOC) shows you how easily you can automate program
  2370. operations, link to external file transfer protocols, assign keys and
  2371. perform a myriad of other functions.
  2372.  
  2373. See Online Help for details on operations within the Macro File window.
  2374.  
  2375.  
  2376. ----------  Compiling Macro Files
  2377.  
  2378. Macro Files may be compiled to increase speed, to reduce size and to
  2379. improve security of source code.  Compiling is done from within the Macro
  2380. File window (see Online Help for the keys used to load and compile Macro
  2381. Files).  The default extension for {COMMO} compiled macros is .CCM, but you
  2382. may edit the filename as desired.
  2383.  
  2384. A compiled Macro File is used in exactly the same way as a source Macro
  2385. File.  The only difference is that in-window operations, such as searching
  2386. for text or starting a macro with the Selector Bar, are not available. 
  2387. This means that the {macro string} style of menus is also not available. 
  2388. Use the MENU function instead.
  2389.  
  2390. TIPS on using compiled macros:
  2391.  
  2392.  *   The Macro Compiler version number in {COMMO} must match the version
  2393.      number in the compiled Macro File.  {COMMO} will issue a warning
  2394.      message if they are different.  To see the version number in the file,
  2395.      use the DOS "type" command or your favorite file viewer or editor.
  2396.  
  2397.  
  2398.  
  2399.                                     -46-
  2400.  
  2401.  *   Macro function names (LOOKfor, SEND, etc.) are checked for validity at
  2402.      compile time, but all other errors are reported at run time.  Be aware
  2403.      that the location of the error cannot be shown without the source
  2404.      macros.
  2405.  
  2406.  
  2407. -----=====  [Alt-N]  Multi Number Dialing
  2408.  
  2409. Any number of entries may be "marked" in the Dialing Directory, then
  2410. automatically dialed in sequence until a connection is established.  Multi
  2411. Number Dialing may be initiated in one of four ways:
  2412.  
  2413. 1)   Bring up the Dialing Directory window with Alt-D, then move the
  2414.      Selector Bar to each desired entry and press [Space] (repeat the
  2415.      procedure to unmark an entry).  Press Alt-N to begin dialing at the
  2416.      location of the Selector Bar.
  2417.  
  2418.      You can also press [T] to tag an entry without moving the Selector
  2419.      Bar.  Press [R] to untag an entry.  These keys are especially helpful
  2420.      to users with speech synthesizer equipment.
  2421.  
  2422. 2)   Specify entries with Dialing Strings on the command line used to run
  2423.      {COMMO} (see "Command Line Options").  Specified entries will be
  2424.      marked and dialed in sequence when {COMMO} is started.
  2425.  
  2426. 3)   Specify entries with Dialing Strings in a macro, using the MARK macro
  2427.      function.
  2428.  
  2429. 4)   Press Alt-N from the Terminal Screen.  Dialing of marked entries will
  2430.      resume with the next system in the sequence.
  2431.  
  2432. See also "[Alt-D]  Dialing Directory" and the DIAL function in Part II
  2433. (MACRO.DOC). 
  2434.  
  2435.  
  2436. -----=====  [Alt-O]  Send Modem Initialization String
  2437.  
  2438. Pressing Alt-O at any time from the Terminal Screen will cause the Modem
  2439. Initialization String to be sent to the modem (if one is defined).  This is
  2440. useful if your modem was powered off or if the modem setup was changed.
  2441.  
  2442.  
  2443. -----=====  [Alt-P]  Set Terminal Parameters
  2444.  
  2445. The Terminal Parameters determine the method of transmission of data to and
  2446. from your computer.  In {COMMO}, they are usually displayed or defined with
  2447. a string.  For example:
  2448.  
  2449.      {38400,8n1,1,A,0}     Speed,format,port,terminal,delay.
  2450.  
  2451. {COMMO} keeps two complete sets of Terminal Parameters:
  2452.  
  2453.  
  2454.  
  2455.                                     -47-
  2456.  
  2457.      1)   The CURRENT Parameters, always shown on the left side of the
  2458.           Status Line.  These reflect the current settings.
  2459.  
  2460.      2)   The DEFAULT DIALING Parameters.  These are defined by the
  2461.           {ddp=...} item in the Setup File.  They may be changed with the
  2462.           Alt-P key command (press F2 in the window to change the CURRENT
  2463.           parameters) or with the DPARms macro function.
  2464.  
  2465.           When a number is dialed, the Current Parameters are changed to
  2466.           the Default Dialing Parameters.  Adjustments are then made for
  2467.           any overrides specified in the Dialing Directory entry (see
  2468.           below).
  2469.  
  2470.  
  2471. ----------  Parameter Descriptions
  2472.  
  2473.  
  2474. -----  Speed
  2475.  
  2476. The rate at which data travels between your computer and your modem (or
  2477. remote system if no modem is used).  It is specified as "bits per second"
  2478. or "bps."  Allowable values are 300, 600, 1200, 2400, 4800, 9600, 19200,
  2479. 38400, 57600, 115200.  These may be abbreviated to the first two characters
  2480. in Terminal Parameter strings.
  2481.  
  2482.  
  2483. -----  Data Format
  2484.  
  2485. This consists of three parts.  Allowable values are:
  2486.  
  2487.      character length:  7, 8
  2488.      parity:  [n]one, [e]ven, [o]dd, [m]ark, [s]pace
  2489.      stop-bits:  1, 2
  2490.  
  2491. Examples:
  2492.  
  2493.      7o2     7 bit characters, odd parity, 2 stop bits
  2494.      8m1     8 bit characters, mark parity, 1 stop bit
  2495.  
  2496. The most common formats, "8n1" and "7e1", may be abbreviated to "8" and "7"
  2497. in Terminal Parameter strings, such as:
  2498.  
  2499.      {38400,8,1,A,0}
  2500.  
  2501.  
  2502. -----  Serial Port
  2503.  
  2504. This is the channel your computer uses to talk to the outside world.  May
  2505. be 1, 2, 3 or 4 (for COM1, COM2, COM3 or COM4).
  2506.  
  2507. NOTE:  PCjr users without the internal modem should specify COM2.
  2508.  
  2509.  
  2510.  
  2511.                                     -48-
  2512.  
  2513. -----  Terminal Emulation Type
  2514.  
  2515. {COMMO} supports the following terminal types:
  2516.  
  2517.      ANSI-BBS  (A)
  2518.           For calling most bulletin board systems.
  2519.  
  2520.      VT102     (V)
  2521.           For calling certain mainframes and online services.
  2522.  
  2523.      TTY       (T)
  2524.           For turning off almost all control functions (lets you see ANSI
  2525.           control sequences).
  2526.  
  2527.  
  2528. -----  Inter-Character Delay
  2529.  
  2530. This factor defines the amount of delay to insert between characters
  2531. transmitted by the SEND macro function and by ASCII Upload.  Use only when
  2532. the remote is too slow to process the data (drops characters).
  2533.  
  2534. Each unit is about 5 thousandths of a second (5 ms) on a 4.77 MHz XT class
  2535. machine.  Faster machines require higher values -- on a 12 MHz AT each unit
  2536. will only be about 1 ms.
  2537.  
  2538. For example, to delay 20 ms between characters (50 cps) use a factor of:
  2539.  
  2540.            4 on 4.77 MHz XT
  2541.           16 on 12 MHz AT
  2542.           27 on 20 MHz 386
  2543.           55 on 25 MHz 486
  2544.  
  2545. The factor will also vary when you use multi-tasking software, so adjust as
  2546. necessary.  The maximum delay allowed is one second.
  2547.  
  2548.  
  2549. ----------  How to Set Terminal Parameters
  2550.  
  2551.  
  2552. -----  With the Alt-P Key Command
  2553.  
  2554. Alt-P may be used at any time to change the DEFAULT DIALING Parameters or
  2555. the CURRENT Parameters (use F2 to toggle between the two sets).  Remember
  2556. that Current Parameters will be reset to the Default Dialing Parameters
  2557. whenever dialing begins.
  2558.  
  2559.  
  2560. -----  In the Dialing Directory
  2561.  
  2562. Serial Port Parameters may be specified in a Dialing Directory entry to
  2563. OVERRIDE the Default Dialing Parameters.  Specify only values that are
  2564. different.  For example:
  2565.  
  2566.  
  2567.  
  2568.                                     -49-
  2569.  
  2570.      {,,3,V}
  2571.           A different serial port and terminal emulation is required for
  2572.           this call.
  2573.  
  2574.      {,7e1}
  2575.           Different format required.
  2576.  
  2577.  
  2578. -----  Using the Macro functions PARMs and DPARms
  2579.  
  2580. Use these to set Terminal Parameters during macro execution.  See Part II
  2581. (MACRO.DOC) for details.
  2582.  
  2583.  
  2584. -----=====  [Alt-S]   Shell to DOS
  2585.  
  2586. When you Shell to DOS {COMMO} remains resident in memory and you may
  2587. perform any DOS functions as you normally do.  Since {COMMO} is small in
  2588. size, most of your memory is available when you use this key command.
  2589.  
  2590. If you need additional memory, you can use {COMMO}'s Swap to Disk feature. 
  2591. To use this feature you will need to do two things:
  2592.  
  2593.      1)   Be sure that a Swap File is specified in your Setup File (look
  2594.           for the "swp=" item under "Paths and Files").
  2595.  
  2596.      2)   Enter the following simple macro in your Macro File:
  2597.  
  2598.                {:als} {shell-s} {}
  2599.  
  2600.           This macro will Shell to DOS using Swap to Disk when you press
  2601.           Alt-S (by using a different key assignment, Alt-S can still be
  2602.           used for Shell to DOS with no swap).
  2603.  
  2604.  
  2605. -----=====  [Alt-T]  Set Toggles
  2606.  
  2607. This key command is used to set a number of miscellaneous toggle (yes/no)
  2608. parameters.  Some take effect while you are still in the Set Toggles window
  2609. -- others when you exit the window.
  2610.  
  2611. Some of the toggles will be described here.  The others are detailed in
  2612. their respective sections of this document.
  2613.  
  2614.  
  2615. ----------  Sound Control Toggle
  2616.  
  2617. This is the Master Sound Control toggle.  When sound is OFF all alarms,
  2618. sounds and beeps will be silenced.  Alarms are individually controlled with
  2619. items in the Setup File and with the "A" switch in EXECute macro functions.
  2620.  
  2621.  
  2622.  
  2623.                                     -50-
  2624.  
  2625. ----------  Local Echo Toggle
  2626.  
  2627. Local Echo (sometimes called half-duplex) is normally used when you connect
  2628. to a host that does not echo (i.e., send back) what you type.  Also,
  2629. {COMMO} will assume that the host is sending a linefeed along with each
  2630. carriage return.
  2631.  
  2632. Typed characters will be displayed directly to the screen.
  2633.  
  2634.  
  2635. ----------  Signal Lights Toggle
  2636.  
  2637. Turns ON/OFF the "modem lights" display on the Status Line.  Shows the
  2638. state of the RS-232C signals, including send and receive.
  2639.  
  2640. This toggles the right half of the Status Line from the System Name to the
  2641. Signal Lights Display.  See "What is on the Status Line" in Online Help for
  2642. a complete description of the Status Line indicators.
  2643.  
  2644.  
  2645. -----=====  [Alt-U]  Utility Menu
  2646.  
  2647. The Utility Menu is supported by a macro in COMMO.MAC.  It contains a
  2648. selection of features created by {COMMO} macros.
  2649.  
  2650. Example features include:
  2651.  
  2652.      Edit any external text file less than 64k in size.
  2653.      Run any macro by name (label).
  2654.      Load any Macro File.
  2655.      Run the host mode macro, MOSTHOST.MAC.
  2656.      Edit the host mode macro.
  2657.  
  2658. NOTE:  The Utility Menu may not be available (or may have different
  2659. features on its menu) if an auxiliary Macro File has been loaded.
  2660.  
  2661.  
  2662. -----=====  [Alt-W]  Send Current Password
  2663.  
  2664. Each entry in the Dialing Directory can have its own Password String. 
  2665. After dialing a number, the Alt-W key command will send the current
  2666. Password String to the remote system.
  2667.  
  2668. Usually, a carriage return must be sent following the Password String. 
  2669. This can be done manually by pressing Enter after pressing Alt-W.  Or you
  2670. can send the carriage return automatically in one of following ways:
  2671.  
  2672.      1)   Place a "|" after the password in each of your Dialing Directory
  2673.           entries.  For example:
  2674.  
  2675.                {pword|}
  2676.  
  2677.  
  2678.  
  2679.                                     -51-
  2680.  
  2681.      2)   Use the following macro which will replace the default Alt-
  2682.           W
  2683.           command:
  2684.  
  2685.                {:alw} {send %_pas|} {}
  2686.  
  2687. For additional details on Passwords see "[Alt-D]  Dialing Directory."
  2688.  
  2689.  
  2690. -----=====  [Alt-X]  Exit from {COMMO}
  2691.  
  2692. This key command will cause {COMMO} to terminate, saving support files with
  2693. outstanding changes.
  2694.  
  2695. You may configure {COMMO} to leave DTR high when exiting so that you may
  2696. exit and remain connected to a system (this is the default, see "[Alt-G] 
  2697. Edit Setup File").
  2698.  
  2699. If you re-enter {COMMO} while still online you should use the "/in" command
  2700. line switch to prevent the Modem Initialization String from being sent.
  2701.  
  2702. Alt-X may also be pressed from the Dialing Directory, Macro File or
  2703. Scrollback windows for a quick exit.
  2704.  
  2705.  
  2706. -----=====  [Alt-1]  Capture File Options
  2707.  
  2708. When Capture is OPEN all information displayed to your screen will be saved
  2709. to the designated disk file.  This command allows you to:
  2710.  
  2711.      1)   OPEN/CLOSE the Capture File.
  2712.      2)   Change to a different file.
  2713.      3)   Change the Capture Mode.
  2714.  
  2715. Data may be captured in one of three different modes.  The startup Capture
  2716. Mode is selected in the Setup File.
  2717.  
  2718.      If the mode is set to SCREEN, data will be captured exactly as it
  2719.      appears on the Terminal Screen (note that lines that wrap on the
  2720.      screen will appear as separate lines in the output file).  This mode
  2721.      greatly improves the appearance of the data captured from screens
  2722.      drawn with ANSI positioning sequences (e.g., animation).
  2723.  
  2724.      FILTER mode is used primarily when you need to capture lines longer
  2725.      than the width of the screen (e.g., to be printed on a wide carriage
  2726.      printer).  Characters will be translated if the receive Translate
  2727.      Table is on.  ANSI control sequences will be stripped out if ANSI-BBS
  2728.      or VT102 emulation is on.
  2729.  
  2730.      Use RAW mode when you want all data captured exactly as it comes from
  2731.      the serial port.  ANSI control sequences will not be stripped and
  2732.      length of lines will be preserved.  This mode can be used to capture
  2733.      ANSI animation and color to be "played back" later.
  2734.  
  2735.  
  2736.  
  2737.                                     -52-
  2738.  
  2739.  
  2740. TIPS on using the Capture File:
  2741.  
  2742.  *   IMPORTANT!  When capturing to a floppy drive, the diskette should not
  2743.      be removed until the Capture File is closed (this also applies if the
  2744.      "disk full" message appears).  DOS is unaware of a disk change and may
  2745.      overwrite the directory on the replacement disk.
  2746.  
  2747.  *   Some screens created with ANSI-BBS or VT102 emulation may appear
  2748.      distorted in the Capture File.  This is because the data was not
  2749.      received in sequence.
  2750.  
  2751.  *   When using SCREEN mode, data currently on the screen will not be
  2752.      written to the Capture File until the screen is cleared, the file is
  2753.      closed, etc.  This is a result of the nature of SCREEN mode and is
  2754.      quite normal.
  2755.  
  2756.  *   If the disk fills up while capture is open, a "disk full" message will
  2757.      appear for several seconds.  The file will be closed and processing
  2758.      will continue.  The built-in variable "_dfc" will be set to 1.
  2759.  
  2760.  *   The old file will be closed if a new file is opened.
  2761.  
  2762. See also "[Alt-I]  Screen Image Save."
  2763.  
  2764.  
  2765. -----=====  [Alt-2]  Print Log Toggle
  2766.  
  2767. Turns the Print Log ON/OFF.  When ON all information written to your screen
  2768. will be printed to LPT1.  Handy for getting hard-copy of file lists,
  2769. messages, etc.
  2770.  
  2771. TIPS on using the Print Log:
  2772.  
  2773.  *   Some screens created with ANSI-BBS or VT102 emulation may appear
  2774.      distorted in the Print Log.  This is because the data was not received
  2775.      in sequence.
  2776.  
  2777.  *   Data currently on the screen will not be printed until the screen is
  2778.      cleared, the Print Log is turned OFF, etc.
  2779.  
  2780.  *   Flow Control should be used if your printer cannot keep up with the
  2781.      incoming data (see Appendix C).
  2782.  
  2783.  
  2784. -----=====  [Alt--]  Chat Mode Toggle  (Alt minus)
  2785.  
  2786. Chat Mode is normally used when you wish to converse via keyboard. The
  2787. screen will be split with the upper portion showing what the remote is
  2788. sending, while the lower portion shows what you type.
  2789.  
  2790. The method used to send typed characters is selected in the Setup File
  2791. under the section "Video and Chat Mode."  The two possible methods are:
  2792.  
  2793.  
  2794.  
  2795.                                     -53-
  2796.  
  2797.  
  2798.      1)   Each character is sent as you type it.  This method is normally
  2799.           used when you are chatting with another person who is also in
  2800.           Chat Mode.
  2801.  
  2802.      2)   All characters are sent at once when you press Enter (up to 240
  2803.           characters will be buffered).  Use this method when you are using
  2804.           a teleconferencing system or "CB Simulator."
  2805.  
  2806. The number of lines in the upper and lower portions of the screen (the
  2807. "line split") may also be set in the "Video and Chat Mode" section.
  2808.  
  2809. TIPS on using Chat Mode:
  2810.  
  2811.  *   Alt-- (Alt minus) is used to enter AND exit Chat Mode.
  2812.  
  2813.  *   All {COMMO} functions are available in Chat Mode except Doorway Mode.
  2814.  
  2815.  
  2816. -----=====  [Alt-=]  Doorway Mode Toggle
  2817.  
  2818. Definition: "Extended" keys are function keys, Alt keys, cursor keys, etc. 
  2819. In other words, keys that do not generate ASCII characters.
  2820.  
  2821. In Doorway Mode all extended keys will send their key codes to the remote
  2822. (instead of activating {COMMO} functions).  Thus Doorway Mode can be used
  2823. to operate most application software on the remote system when used with a
  2824. host program such as Marshall Dudley's DOORWAY.  In addition, some BBS
  2825. full-screen editors use Doorway Mode.
  2826.  
  2827. TIPS on using Doorway Mode:
  2828.  
  2829.  *   IMPORTANT!  {COMMO} supports host printer redirection.  This means
  2830.      that Doorway may send data through the modem to be printed on LPT1,
  2831.      LPT2 or LPT3.  Be sure the printers are ready before starting or your
  2832.      system may hang.
  2833.  
  2834.  *   The Alt-= key is the default, but the "dmk" item in the Setup File may
  2835.      be used to define any key.   The defined key is necessarily reserved
  2836.      for exiting Doorway Mode and thus cannot be sent to the remote.  Be
  2837.      sure to configure remote applications accordingly.
  2838.  
  2839.  *   A macro must be present in the Macro File to toggle Doorway Mode.  The
  2840.      supplied macro is:
  2841.  
  2842.           {:al=} {doorway} {}         Toggle Doorway Mode
  2843.  
  2844.      If you redefine the key with "dmk", don't forget to change the key-
  2845.      label on the macro.
  2846.  
  2847.  *   Terminal-type should be set to ANSI-BBS.  It's a good idea to enter
  2848.      Doorway Mode before starting the host program.  The host may send
  2849.      commands to initialize the terminal.
  2850.  
  2851.  
  2852.  
  2853.                                     -54-
  2854.  
  2855.  
  2856.  *   When used with DOORWAY 2.22 or later, the Doorway Mode macro will
  2857.      execute automatically when the DOORWAY program (on the host system)
  2858.      starts up and when it exits back to DOS -- no keypress is necessary.
  2859.  
  2860.      (Note that this feature is unavailable during shareware evaluation.)
  2861.  
  2862.  *   The display should be set to the number of lines expected by the host
  2863.      program.  Usually this is 25 lines of text.  If your display is not in
  2864.      the proper mode, the results will be unpredictable.
  2865.  
  2866.  *   The Status Line is normally suppressed in Doorway Mode, but may be
  2867.      turned on by using the "S" switch in the Doorway macro:
  2868.  
  2869.           {:al=} {doorway-s} {}
  2870.  
  2871.      The "s" switch is ignored when exiting Doorway Mode and the Status
  2872.      Line will be restored to its previous state.  Remember that when the
  2873.      Status Line is on, there is one less usable line on the Terminal
  2874.      Screen.
  2875.  
  2876.  *   If it is necessary to clear the screen or to reset the terminal
  2877.      emulation mode parameters when starting Doorway Mode, modify the
  2878.      Doorway macro.  For example:
  2879.  
  2880.           {:al=} {clear} {parms ,,,a} {doorway} {}
  2881.  
  2882.      This macro will execute when entering or exiting Doorway Mode.
  2883.  
  2884.  *   If Software Flow Control is enabled, the ASCII character values 17 and
  2885.      19 (XON and XOFF) will not display.  If these characters are needed,
  2886.      Software Flow Control should be turned off.
  2887.  
  2888.  
  2889. -----=====  [F1]  How to Use Online Help
  2890.  
  2891. A summary of {COMMO}'s operations is available by pressing F1.  The Online
  2892. Help support file, COMMO.HLP, must be in the {COMMO} home directory or you
  2893. will get an error message.  This message will also be issued if there is
  2894. not enough memory to load the Online Help file.
  2895.  
  2896. Note that the Help file is retained in memory until {COMMO} requires memory
  2897. for some other program function.  It will automatically be re-read when
  2898. necessary. 
  2899.  
  2900. Press "H" in the Help window for a description of all keys available in the
  2901. window.  Keys for each of {COMMO}'s command windows are detailed in the
  2902. respective help sections.
  2903.  
  2904.  
  2905.  
  2906.                                     -55-
  2907.  
  2908. ----------  Modifying the Help File
  2909.  
  2910. When you are familiar with {COMMO} you may wish to reduce the size of the
  2911. Help File.  Feel free to edit this file -- you can even set up your own
  2912. menu.
  2913.  
  2914. The search keys are in the bars separating the topics.  The character
  2915. following the "T" in the middle of the bar may be changed to create your
  2916. own key.  Keep in mind that the context-related Help uses topic characters
  2917. that cannot be changed.
  2918.  
  2919. The HELP macro function enables you to assign a key to go directly to any
  2920. topic in Online Help.  For example:
  2921.  
  2922.           {:cf6} {help J} {}
  2923.  
  2924. will go to topic "TJ" when Ctrl-F6 is pressed.  Use any single character as
  2925. the key (do not include the "T").
  2926.  
  2927. If you change the Help File, remember to keep a backup copy of the
  2928. original.
  2929.  
  2930.  
  2931. -----=====  [PgUp]/[PgDn]  Uploading/Downloading
  2932.  
  2933. When you press PgUp or PgDn you will be presented with a menu of file
  2934. transfer protocols.  Protocols provide the ability to transfer (send and
  2935. receive) any type of data using error detection and correction techniques.
  2936.  
  2937. The PgUp and PgDn menus are implemented using {COMMO}'s powerful Macro
  2938. Language which enables you to execute internal and external protocols
  2939. easily and seamlessly.
  2940.  
  2941. Files for uploading (sending) are chosen from the file selection menu. 
  2942. Only one file should be selected when using the Xmodem or Kermit protocols.
  2943.  
  2944. You may alter these macros to suit your individual needs.
  2945.  
  2946.  
  2947. ----------  Internal Protocols
  2948.  
  2949. {COMMO} provides an extremely fast and efficient version of the Zmodem
  2950. protocol, plus a number of variations on the Xmodem and Ymodem protocols. 
  2951. These afford you varying degrees of convenience, speed and security.
  2952.  
  2953. ZMODEM is the preferred protocol on most host systems.  It features
  2954. automatic startup of downloads, multi-file transfers and automatic naming
  2955. and dating of received files.  Zmodem also affords greater data security
  2956. through its 32 bit cyclic redundancy check and its ability to resume
  2957. transfers that were interrupted (e.g., by loss of carrier).
  2958.  
  2959.  
  2960.  
  2961.                                     -56-
  2962.  
  2963. The "zr_mode" variable item in COMMO.SET controls the disposition of like-
  2964. named files when downloading.  Four options are available when the incoming
  2965. filename matches a filename in the Download Directory (choose only one):
  2966.  
  2967.      [S]kip -- The file will be skipped (not downloaded).
  2968.  
  2969.      [R]esume -- The file will be resumed (appended to) if the file in the
  2970.      Download Directory is smaller than the incoming file.  Otherwise, the
  2971.      transfer will be considered complete.
  2972.  
  2973.      re[N]ame -- The incoming file will be renamed by changing the last
  2974.      character of "filename.ext" to a letter from A through Z.
  2975.  
  2976.      [O]verwrite -- The existing file will be deleted and the incoming file
  2977.      will replace it.
  2978.  
  2979. YMODEM is also capable of multi-file transfers and automatic naming/dating
  2980. of incoming files.  Note that the standard macros are set to cancel a
  2981. download when a like-named file is received.  {COMMO}'s Ymodem supports
  2982. renaming and overwriting (as in Zmodem), but you must modify the macros in
  2983. COMMO.MAC to do this (there is no menu support).
  2984.  
  2985. XMODEM is the most basic protocol.  A filename must be supplied at both
  2986. ends of the transfer (they need not be the same).
  2987.  
  2988. There are a number of variations which apply to both Xmodem and Ymodem. 
  2989. Their use depends upon what is offered by the remote system and whether or
  2990. not you have an error-correcting modem.
  2991.  
  2992.      CRC
  2993.           This is a reliable block-check method and should be used whenever
  2994.           possible.
  2995.  
  2996.      Csum
  2997.           This block-check method is not as reliable and should not be used
  2998.           unless there is no other option.
  2999.  
  3000.      1k byte block size
  3001.           The larger block size is much more efficient and is preferred
  3002.           (unless noisy lines are causing a lot of block retransmissions).
  3003.  
  3004.      128 byte block size
  3005.           The small block size should be used only when there is no other
  3006.           option or on noisy lines.
  3007.  
  3008.      G
  3009.           The "G" method eliminates waiting for the receiver's response to
  3010.           each block and is therefore much faster.  It still performs error
  3011.           checking, but not error recovery.  Therefore it should only be
  3012.           used with an error-correcting modem or on a direct connection
  3013.           between computers.
  3014.  
  3015.  
  3016.  
  3017.                                     -57-
  3018.  
  3019.           When an error is encountered, the transfer will be cancelled. 
  3020.           Partial files will be kept.  The "G" method always uses CRC and
  3021.           1k blocks.
  3022.  
  3023. IMPORTANT!  The macros that support the internal protocols are set up for
  3024. the most common situations.  Many variations are possible by modifying
  3025. these macros.  Please refer to descriptions of the functions RZMOdem,
  3026. RYMOdem, RXMOdem, SZMOdem, SYMOdem and SXMOdem in Part II (MACRO.DOC) for
  3027. details.
  3028.  
  3029.  
  3030. ----------  ASCII Upload/Download
  3031.  
  3032. Text files may be sent and received using the ASCII protocol.  This method
  3033. performs no error checking or error correction and should only be used when
  3034. other protocols are not available.
  3035.  
  3036. It might be used, for example, to upload a prepared message to a host that
  3037. was waiting for you to type the message.  Or it could be used to receive a
  3038. bulletin or other information that you would normally read while on line.
  3039.  
  3040. To upload a text file, use the Alt-A key command.  See "[Alt-A]  ASCII
  3041. Upload."
  3042.  
  3043. To download text information to a file, use {COMMO}'s Capture File feature. 
  3044. Use the Alt-1 key command to set the filename and Capture Mode.  Open the
  3045. Capture File just prior to receiving the information.  Then close it after
  3046. all data has been received.  Note that the file may require some editing. 
  3047. See "[Alt-1]  Capture File Options."
  3048.  
  3049.  
  3050. ----------  External Protocols
  3051.  
  3052. The Macro File is pre-configured with macros that execute various external
  3053. protocol programs.  You may add macros for any other protocol programs that
  3054. you need.  See Part II (MACRO.DOC) for details on writing macros.
  3055.  
  3056. External protocol programs can be obtained from BBS's and other sources. 
  3057. To install them, just place the executable files (e.g., HSLINK.EXE,
  3058. OZBEXT.EXE, DSZ.COM) in the directory which is specified in the "set
  3059. protodir" Setup File item.  This item is in the "Paths and Files" section
  3060. of COMMO.SET.  You may use your {COMMO} home directory, if desired.
  3061.  
  3062. IMPORTANT!  All external protocol programs must be in the "protodir"
  3063. directory.
  3064.  
  3065. Each of the protocol programs has additional features that may be useful to
  3066. you.  Refer to the program's documentation for more information.
  3067.  
  3068.  
  3069.  
  3070.                                     -58-
  3071.  
  3072. -----  Using HS/Link
  3073.  
  3074. HS/Link is a Shareware program that offers very fast file transfers.  The
  3075. HS/Link protocol has all of the features of Zmodem.  In addition, it has
  3076. bi-directional capability for uploading and downloading simultaneously with
  3077. a full-duplex modem (make sure the remote system allows this feature before
  3078. attempting it).
  3079.  
  3080. When you select a download with HS/Link (or if it is started automatically,
  3081. see "Auto Receive"), you will be asked if you have "Any files to upload" as
  3082. well.  Answer "no" (or just press Enter) for download only.
  3083.  
  3084. The executable file to install is HSLINK.EXE.
  3085.  
  3086.  
  3087. -----  Using Kermit
  3088.  
  3089. Kermit is a protocol that is often the only choice on institutional host
  3090. systems.  To use Kermit, you must obtain Columbia University's MSKERMIT 3.0
  3091. or later.  This program is free for personal use and is almost universally
  3092. available on BBS's and commercial services.  The Kermit macros are set up
  3093. to transfer only one file at a time (no batch mode).
  3094.  
  3095. The executable file to install is KERMIT.EXE.
  3096.  
  3097.  
  3098. -----  Using OZBEXT
  3099.  
  3100. OZBEXT is a file transfer program for CompuServe users (download it from
  3101. CIS in the IBMCOM forum under Protocols -- it is free for personal use). 
  3102. This protocol generally offers better network throughput than Xmodem or
  3103. Ymodem (see note below).
  3104.  
  3105. When you see the protocol selection menu on CompuServe, always select the
  3106. "B" or "B+" protocol (NOT "Quick B").
  3107.  
  3108. The executable file to install is OZBEXT.EXE.
  3109.  
  3110. NOTE:  If you select Ymodem or Xmodem on CIS to download a file, you will
  3111. get much faster throughput by choosing the "G" variation in {COMMO} --
  3112. Ymodem-G or Xmodem-G.  Unless you do a lot of uploading, use of OZBEXT
  3113. should not be necessary.
  3114.  
  3115.  
  3116. -----  External Zmodem
  3117.  
  3118. Some users may prefer to use an external Zmodem driver.  This can be done
  3119. easily by entering replacement macros for "z_recv" and "z_send".  If you
  3120. add these at the top of COMMO.MAC, you won't have to change the existing
  3121. macro structure (the new macros will override the old).
  3122.  
  3123. Example macros for Omen Technology programs and Texas Zmodem are shown in
  3124. SAMPLES.MAC.
  3125.  
  3126.  
  3127.  
  3128.                                     -59-
  3129.  
  3130.  
  3131.  
  3132. -----=====  {COMMO} Auto Receive
  3133.  
  3134. This feature will automatically start a macro when a specified string is
  3135. received from the serial port and may be used for starting downloads.
  3136.  
  3137. Up to 16 strings and respective macro labels may be defined in the
  3138. "Terminal and Modem" section of the Setup File.  These are preconfigured
  3139. for the Zmodem and HS/Link protocol "signature" strings, but you may change
  3140. them or add new ones as desired.
  3141.  
  3142. As an example, one of the Auto Receive strings in the Setup File is:
  3143.  
  3144.   {aut=pzbr,^XB00}    Auto Receive, Zmodem DL
  3145.  
  3146. This means that when the string "^XB00" is received, the macro at label
  3147. "pzbr" will be started.  This string is the Zmodem "signature" string and
  3148. is sent repeatedly by the sender until the receiver is ready to receive
  3149. files.
  3150.  
  3151. In the Macro File you will find the corresponding macro:
  3152.  
  3153.   Zmodem   {:pzbr} ... {call z_recv} {}
  3154.  
  3155. {COMMO} will execute the macro as soon as the signature string is received
  3156. (be patient, a BBS may take several seconds to load and execute its own
  3157. protocol program).
  3158.  
  3159. IMPORTANT!  If you have not properly installed an external protocol
  3160. program, the message "Bad command or file name" will be periodically
  3161. displayed by DOS.  If this happens type Ctrl-X repeatedly until the sender
  3162. cancels the transfer.
  3163.  
  3164. TIPS on using Auto Receive:
  3165.  
  3166.  *   If the macro called by Auto Receive EXECutes a DOS command, you may
  3167.      want to use EXECute Preview Mode for preliminary testing.  This will
  3168.      allow you to view the command before execution and to see the results
  3169.      afterwards.  Preview Mode may be toggled on/off using the Alt-T key
  3170.      command.
  3171.  
  3172.  *   Auto Receive will not trigger on characters that are displayed to the
  3173.      screen while a macro is running.  If you need to download within a
  3174.      macro, you should do a LOOKfor to wait for the signature string, then
  3175.      CALL the download macro.
  3176.  
  3177.  *   Using short strings, such as "^E" for CIS B protocol may result in
  3178.      unexpected triggering of the macro.  This is because other systems may
  3179.      send the same string for a different purpose (to display a "club"
  3180.      symbol, for example).  Thus it may be necessary to disable a string at
  3181.      times or to discontinue its use.
  3182.  
  3183.  
  3184.  
  3185.                                     -60-
  3186.  
  3187.  *   A string may be disabled by removing the corresponding macro label in
  3188.      the Macro File.  This may degrade performance since the Macro File
  3189.      must be scanned each time a "hit" occurs.  The best way is to remove
  3190.      the Setup File item.
  3191.  
  3192.  *   Auto Receive can be set up for protocols that do not send signature
  3193.      strings, such as Xmodem, Ymodem, Ymodem-G, etc.  Use the prompt that
  3194.      the BBS sends just prior to the file transfer.  For example, "Start
  3195.      your Ymodem-G now."  Note that different systems may use different
  3196.      prompts.
  3197.  
  3198.  *   The AUTO macro function may be used to define new strings after
  3199.      program startup.  See Part II (MACRO.DOC) for details.
  3200.  
  3201. See also "TIPS on creating LOOKfor strings" in Part II (MACRO.DOC) under
  3202. LOOKfor.
  3203.  
  3204.  
  3205. -----=====  Keyboard Macros: Customizing Key Commands
  3206.  
  3207. In {COMMO} you can assign a key to perform almost any program function or
  3208. combination of functions.  For example, suppose you want to press Ctrl-F5
  3209. to send your name followed by a carriage return.  You can enter a simple
  3210. macro in your Macro File to do this.
  3211.  
  3212. Press Alt-M, then "E" to edit.  Position the cursor where you want your new
  3213. macro to be, then press Alt-I a few times to open some space.  Now type in
  3214. this macro:
  3215.  
  3216.      {:cf5} {send First Last|} {}
  3217.  
  3218. This simple macro has the basic components of any macro.
  3219.  
  3220.      {:cf5}        label (the entry point).
  3221.      {send ...}    function (the action part).
  3222.      {}            STOP (to terminate the macro).
  3223.  
  3224. When Ctrl-F5 is pressed, {COMMO} will search the Macro File for {:cf5} and
  3225. execute the macro function(s) that follow.  In this case the string "First
  3226. Last|" will be sent to the serial port.  Notice that the "|" converts to a
  3227. carriage return.
  3228.  
  3229. A keyboard macro may also be used to change a default key assignment.  For
  3230. example, Alt-K will normally bring up the Scrollback Buffer window.  If
  3231. you'd rather use the Up Arrow key for this purpose, enter this macro:
  3232.  
  3233.      {:upa} {scroll} {}
  3234.  
  3235. TIPS on creating keyboard macros:
  3236.  
  3237.  *   The "key-labels" used to start keyboard macros may be predefined or
  3238.      user-defined.  See Appendix H "{COMMO} Macro Key-labels" for complete
  3239.      details.
  3240.  
  3241.  
  3242.  
  3243.                                     -61-
  3244.  
  3245.  
  3246.  *   Appendix D explains how to represent special characters (such as
  3247.      carriage returns) in macros.
  3248.  
  3249.  *   Press Alt-E while using the Internal Editor to see the complete list
  3250.      of editing keys and editing rules.
  3251.  
  3252.  *   Read Part II (MACRO.DOC) to learn the full power of the {COMMO} macro
  3253.      language.
  3254.  
  3255.  
  3256.  
  3257.                                     -62-
  3258.  
  3259. ==========  Appendix A:  Setting Up Your Modem
  3260.  
  3261. Please be aware that there are many different modems in use and that it is
  3262. of the utmost importance that you configure your modem to work correctly
  3263. with {COMMO}.  A few tips will be given here, but they are not intended as
  3264. a substitute for the detailed installation instructions in your modem
  3265. manual!
  3266.  
  3267. When {COMMO} is started, a command string called the Modem Initialization
  3268. String will be sent to the modem.  You must make certain that you have the
  3269. correct string in your Setup File.  This string will perform part or all of
  3270. the modem setup depending on the type of modem.
  3271.  
  3272. If your modem is external to your computer, be sure you have followed the
  3273. installation instructions carefully and that the cable is connected to the
  3274. computer's serial port.
  3275.  
  3276. Also check the Default Dialing Parameters in the Setup File.  Make sure the
  3277. serial port number is correct.
  3278.  
  3279.  
  3280. -----=====  28800, 14400, 9600, 2400 bps Modems
  3281.  
  3282. IMPORTANT!  Modern modems require that the serial port speed be set higher
  3283. (up to four times higher!) than the modem's fastest line speed.  For
  3284. example, a 14400 bps modem would be used with the port speed set at 19200,
  3285. 38400 or 57600.  The highest speed you can use is dependent on the hardware
  3286. and software in your computer system.  Set the speed in COMMO.SET with the
  3287. {ddp=...} item.
  3288.  
  3289. Many modems have switches (often called "DIP "switches) which must be set
  3290. to provide the proper interaction with your computer and with {COMMO}. 
  3291. Consult your modem manual concerning these switches and pay particular
  3292. attention to the following:
  3293.  
  3294.      1)   Enable command recognition.  Allows the modem to recognize
  3295.           commands (dial, set registers, etc.).  Must be in the "enable"
  3296.           position or modem will be unusable.
  3297.  
  3298.      2)   Send result codes in English.  This switch should be set so that
  3299.           the modem will send verbal responses to commands instead of
  3300.           numbers.  There is usually a command to control this as well
  3301.           (e.g., "V1").
  3302.  
  3303.      3)   Respond to DTR (data terminal ready).  This should NOT be in the
  3304.           "ignore" or "override" position.  This switch allows the computer
  3305.           to signal the modem to hang up.
  3306.  
  3307.      4)   Respond to carrier detect or "allow true carrier."  This should
  3308.           NOT be set to the "always on" or "override" position.
  3309.  
  3310. Modems also have software commands which can be used in place of (or in
  3311. addition to) the switches.  These commands may be given every time you
  3312.  
  3313.  
  3314.  
  3315.                                     -63-
  3316.  
  3317. start {COMMO} or they may be permanently remembered by modems which have
  3318. "non-volatile" memory (NVRAM).
  3319.  
  3320. It will be assumed here that the commands are given every time you start
  3321. {COMMO}.  If you wish to place the settings in NVRAM, consult your modem
  3322. manual for instructions (most modems use the "&W" command to do this).  
  3323.  
  3324. Here is an example Modem Initialization String for most higher speed
  3325. modems:
  3326.  
  3327.      {~~AT S0=0 S7=180 E1 Q0 V1 X4 &C1 &D2 |~~}
  3328.  
  3329. The "X" command may vary somewhat from modem to modem.  It determines which
  3330. responses the modem will generate during dialing (CONNECT, BUSY, etc.).  It
  3331. may also activate an additional modem feature, such as automatic redialing,
  3332. which could interfere with {COMMO}'s own redialing procedure.
  3333.  
  3334. Your modem manual gives a description for each level of the "X" command:
  3335. X0, X1, X2, ... , etc.  Generally you want to use the highest level that
  3336. does not activate undesirable features (usually "X4").  The BUSY response
  3337. should be provided if possible.
  3338.  
  3339. IMPORTANT!  Many modems that operate at 2400 bps and above require
  3340. additional commands to control features such as error correction and data
  3341. compression.  The factory settings are usually correct, but be aware that
  3342. you may need to insert additional commands into the above string.
  3343.  
  3344. If you need to change the Modem Initialization String, edit the Setup File
  3345. with the Alt-G key command, then restart the program to send the string to
  3346. the modem.
  3347.  
  3348.  
  3349. -----=====  1200 bps Modems
  3350.  
  3351. Here is an example Modem Initialization String which will set up a 1200 bps
  3352. modem:
  3353.  
  3354.      {~~AT S0=0 S7=180 E1 Q0 V1 X1 |~~}
  3355.  
  3356. The information above concerning DIP switches and the "X" command usually
  3357. applies to 1200 or 300 bps modems as well.
  3358.  
  3359.  
  3360. -----=====  Answering a call from another computer
  3361.  
  3362. The following information assumes that you are not using the MOSTHOST or
  3363. other {COMMO} host mode macro.  If you use a host macro, follow the
  3364. instructions for installing and operating the host.
  3365.  
  3366. There are two easy ways to use {COMMO} to answer when a friend or associate
  3367. calls you by computer.  For best results, make sure you are in Chat Mode. 
  3368. Press Alt-- (Alt minus) to enter/exit Chat Mode.
  3369.  
  3370.  
  3371.  
  3372.                                     -64-
  3373.  
  3374. 1)   While in Chat Mode or in the Terminal Screen, wait for the phone to
  3375.      ring, then type "ATA<cr>" (upper case is not necessary with many
  3376.      modems).  Your modem should answer immediately (go off hook) and begin
  3377.      handshaking with the remote modem.
  3378.  
  3379.      When you see the CONNECT message you are ready to communicate.  At
  3380.      this point you can type, send data with macro keys, send a text file
  3381.      with ASCII Upload or send any file with an internal or external
  3382.      protocol.
  3383.  
  3384.      You can use a macro key to send the answer command to the modem.  For
  3385.      example, to send it by pressing F5, place the following macro in your
  3386.      Macro File:
  3387.  
  3388.           {:nf5} {send ATA|} {}    Answer the phone!
  3389.  
  3390.      When the telephone rings, press F5.
  3391.  
  3392. 2)   The other method involves setting your modem into Auto Answer Mode. 
  3393.      This method is useful in some situations, but will cause the modem to
  3394.      answer whenever the phone rings.  This can be undesirable if you get a
  3395.      voice call.
  3396.  
  3397.      To set Auto Answer just type "ATS0=1<cr>" (or make "S0=1" part of your
  3398.      Modem Initialization String).  This will tell the modem to answer on
  3399.      ring "1" (adjust to as many rings as desired).  To turn off Auto
  3400.      Answer type "ATS0=0<cr>".  These may also be sent with macro keys. 
  3401.  
  3402.  
  3403. -----=====  Connecting two computers (null modem cable)
  3404.  
  3405. {COMMO} may be used on a "direct connection" between two computers or
  3406. between a computer and another serial device.  Connect the two serial ports
  3407. with a "null modem" cable.  Then start the program on each computer, having
  3408. selected the appropriate Default Dialing Parameters in the Setup File(s).
  3409.  
  3410. Dialing conditions may be simulated by using a null {} phone number and
  3411. "dialing" the entry.  This allows directory entry variables to be set and
  3412. also activates features such as the Usage Log and the elapsed timer on the
  3413. Status Line.  If a Linked Macro is specified, it will be started.
  3414.  
  3415. The null modem cable should be designed so that the transmit line on each
  3416. end connects to the receive line on the other end.  No other signals are
  3417. needed, but none of the RS-232C signals should be left "floating."  They
  3418. should be tied high or low (or grounded).
  3419.  
  3420.  
  3421.  
  3422.                                     -65-
  3423.  
  3424. ==========  Appendix B   {COMMO} and Multi-Tasking
  3425.  
  3426.  
  3427. -----=====  DESQview
  3428.  
  3429. Special care has been taken to ensure that {COMMO} is compatible with
  3430. Quarterdeck Office Systems' DESQview(tm), a multi-tasking supervisor. 
  3431. DESQview allows more than one program to execute at the same time.
  3432.  
  3433. A sample Program Information File (CO-PIF.DVP) has been included in the
  3434. {COMMO} package for your convenience.  The settings in this file assume the
  3435. use of DESQview 386.  If you are running on a 286, you should adjust the
  3436. settings accordingly.  This file is installed as follows:
  3437.  
  3438.      1)   Copy the file to your DESQview directory (usually C:\DV).
  3439.      2)   Run "Add a Program" (AP) from the "Open Window" menu.
  3440.      3)   Select "Other" (move the highlight bar and press Space).  Specify
  3441.           your DESQview directory as the "Path."
  3442.      4)   Mark the {COMMO} entry (with Space), then press Enter.  "CO"
  3443.           should now appear on your "Open Window" menu.
  3444.  
  3445. The CO-PIF.DVP file has been set up to define a 200k memory window.  The
  3446. amount of memory actually required is determined by various factors,
  3447. including the sizes of the COMMO.FON file, COMMO.MAC file, Scrollback
  3448. Buffer, String Variable Space, etc.
  3449.  
  3450. CO-PIF.DVP can be changed with the "Change a Program" (CP) command on the
  3451. "Open Window" menu.  You may also want to change the directory information
  3452. or other parameters.
  3453.  
  3454. If {COMMO} doesn't load, try increasing the memory value by 50k at a time
  3455. until it does.  Then test the size of the window by running HS/Link, LIST,
  3456. etc., from the Macro File window or Shell to DOS.  Be sure to test the
  3457. execution of external programs with a "wait" at the end (or use EXECute
  3458. Preview Mode) so that you can see any error messages (see EXEC function).
  3459.  
  3460. TIPS on using {COMMO} with DESQview:
  3461.  
  3462.  *   For best performance the foreground and background "tick counts"
  3463.      should both be 10 or less.  Tick counts should be reduced when data is
  3464.      being received at very high speeds.
  3465.  
  3466.      For example, receiving uncompressed data can result in serial port
  3467.      speed bursts up to 115200 bps.  In this situation, ticks should be set
  3468.      at 3 and 3.  This will ensure that {COMMO} can get control before too
  3469.      many characters have accumulated in its receive buffer.
  3470.  
  3471.  *   If you switch to another task, do not attempt to access any files
  3472.      which may be in use in the {COMMO} window.  Examples are the Capture
  3473.      File, the Screen Image File and files that may be currently involved
  3474.      in a file transfer (upload or download).  The result may be a loss of
  3475.      part or all of the data in the file.  This is a general DESQview
  3476.  
  3477.  
  3478.  
  3479.                                     -66-
  3480.  
  3481.      no-no.  You may freely access these files in the Shell to DOS or using
  3482.      a macro (within the same window).
  3483.  
  3484.  *   If the memory allocated to the window is too small, {COMMO} will not
  3485.      be able to load the Online Help file.  Since the Online Help file is
  3486.      loaded only when requested, you needn't be concerned if you don't
  3487.      intend to use it.
  3488.  
  3489.  *   The video display may seem less smooth in DESQview.  This is a result
  3490.      of {COMMO} using the fastest possible display method, and is quite
  3491.      normal.  This effect can be minimized by specifying fewer clock ticks
  3492.      for foreground and background (4 and 4 seems to work well). 
  3493.  
  3494.  *   The Snow Checking option should not be used when {COMMO} is run under
  3495.      DESQview.  If you see "snow" type interference in your CGA display,
  3496.      use DESQview's own snow checking (request "synchronized access" in the
  3497.      Setup program).
  3498.  
  3499.  
  3500. -----=====  OS/2 and Windows
  3501.  
  3502. {COMMO} will auto-detect the presence of OS/2 or Windows.  As much
  3503. processing time as possible will be returned to the system for use by other
  3504. tasks.
  3505.  
  3506. As of this writing, users are reporting improved performance under OS/2
  3507. with Ray Gwinn's SIO/VSIO replacement serial port drivers.  These are
  3508. available on CompuServe (go os2user, lib 3), Exec-PC (OS/2 collection) and
  3509. many other BBS systems.  Look for SIOnnn.ZIP.
  3510.  
  3511. Suggested settings for OS/2 DOS session:
  3512.  
  3513.      COM_DIRECT_ACCESS        On
  3514.      COM_HOLD                 On
  3515.      HW_TIMER                 On
  3516.      IDLE_SECONDS             60
  3517.      IDLE_SENSITIVITY         100
  3518.      INT_DURING_IO            On
  3519.  
  3520.  
  3521. -----=====  OmniView
  3522.  
  3523. Display bleed-through may be avoided by telling OmniView that {COMMO}
  3524. "Supports TopView Functions" or by using the "/T" switch on the OmniView
  3525. command line.
  3526.  
  3527. See "TIPS on using {COMMO} with DESQview" in the previous section, most of
  3528. which apply to OmniView as well.
  3529.  
  3530.  
  3531.  
  3532.                                     -67-
  3533.  
  3534. -----=====  DoubleDOS
  3535.  
  3536. Color displays require the "DISPLAY = TEXT" option in DDCONFIG.SYS.  Run
  3537. {COMMO} in the bottom partition -- about 130k to 150k should suffice if you
  3538. plan to use Online Help and/or external protocols.  Increase this size in
  3539. proportion to the size of your Scrollback buffer.
  3540.  
  3541. Some non-multi-tasker-aware, direct-screen-writing programs executed with a
  3542. macro or in the Shell to DOS may not display properly.  If this happens you
  3543. may have to run {COMMO} in the top partition.
  3544.  
  3545. Use the supplied DBLDANSI.SYS driver in place of your ANSI.SYS for running
  3546. other programs in this partition ({COMMO} doesn't use it).
  3547.  
  3548. With this setup you may run any non-graphics program in the top partition,
  3549. including direct screen writers.  
  3550.  
  3551. Monochrome displays require the REFRESH option in DDCONFIG.SYS.  Refer to
  3552. the DoubleDOS user's manual for information on this.
  3553.  
  3554. See "TIPS on using {COMMO} with DESQview" in the previous section, most of
  3555. which apply to DoubleDOS as well.
  3556.  
  3557.  
  3558.  
  3559.                                     -68-
  3560.  
  3561. ==========  Appendix C   Flow Control
  3562.  
  3563. Flow Control is a signalling system used by communications devices to
  3564. prevent data from being transmitted faster than it can be processed by the
  3565. receiving system.  This is especially important when data is transferred at
  3566. high speeds.
  3567.  
  3568. Flow Control is initialized in the Setup File and is used by {COMMO} for
  3569. both sending and receiving.  You may specify Hardware Flow Control,
  3570. Software Flow Control or both.
  3571.  
  3572. Hardware Flow Control uses the RTS/CTS lines in your RS-232C (serial port)
  3573. cable to signal pause/resume without interfering with the data.  It is used
  3574. when you are connected to a device which also recognizes RTS/CTS Flow
  3575. Control (such as a high-speed modem or another computer connected with an
  3576. appropriate null modem cable).  A CTS-off (send) pause will not be released
  3577. automatically.
  3578.  
  3579. Software Flow Control uses a control character called XOFF (or ^S) to
  3580. signal the remote to pause.  XON (^Q) is the signal to "resume
  3581. transmission."  This is normally used only for ASCII data, since these
  3582. characters may appear randomly within binary data.  An XOFF pause will
  3583. automatically be released in 20 seconds if no XON is received.  It will
  3584. also be released if you type a character in the Terminal Screen.
  3585.  
  3586. TIPS on using Flow Control:
  3587.  
  3588.  *   Hardware Flow Control problems can generally be avoided by using the
  3589.      {hfc=auto} option in your Setup File.
  3590.  
  3591.  *   Your modem must be properly initialized to utilize flow control
  3592.      (consult the modem manual for details).
  3593.  
  3594.  *   Since Software Flow Control uses the XOFF (ASCII 19) and XON (ASCII
  3595.      17) characters, these will not display on the screen.  If it is
  3596.      necessary to display them, Software Flow Control must be turned off.
  3597.  
  3598.  *   It is especially important to use Flow Control when the Print Log is
  3599.      on, since data is usually received faster than it can be printed.  If
  3600.      you type a character to the remote during a flow control pause, the
  3601.      remote may begin sending again (some systems resume on any character,
  3602.      not just XON).  You may have to turn off the Print Log if this
  3603.      happens.
  3604.  
  3605.  
  3606.  
  3607.                                     -69-
  3608.  
  3609. ==========  Appendix D   ASCII Character Representation
  3610.  
  3611. Sometimes it is necessary to enter control characters and other special
  3612. characters in the {COMMO} support files or as input to {COMMO} key
  3613. commands.  For example, a carriage return (typed with the Enter key) is
  3614. used to terminate your typed input.  Therefore a carriage return must be
  3615. represented by some other character (or characters) in order to be used as
  3616. data.
  3617.  
  3618. The process of converting represented characters to actual characters is
  3619. done in many places in {COMMO}.  Some examples are:
  3620.  
  3621.      1)   Strings sent to the modem.  These include the Modem
  3622.           Initialization String, dialing prefixes and suffixes, telephone
  3623.           numbers, the Password String, strings used in macro functions
  3624.           such as SEND, SETLook (prompt response), VTCUr and VTPAd.
  3625.  
  3626.      2)   Strings used in other macro functions such as LOOKfor, GOLOok,
  3627.           CALOok, SSLOok, EXECute and DISPlay.  The pacing character in
  3628.           ASCII Upload is also converted.
  3629.  
  3630. All control characters may be represented using the (^) caret symbol (it is
  3631. the shift character above the top row "6").  If you need to send a caret,
  3632. use two carets (^^).
  3633.  
  3634. For convenience, two "normal" characters have special meanings in certain
  3635. contexts:
  3636.  
  3637.      The vertical bar (|) may be used to represent a carriage return.  If
  3638.      you need a vertical bar, use (^|).  In the EXECute function the
  3639.      vertical bar is never converted (it is used by DOS as the "pipe"
  3640.      symbol).
  3641.  
  3642.      The tilde (~) forces a one-half second delay when it is encountered in
  3643.      a string that is being sent to the modem.  If you need to send a
  3644.      tilde, use (^~).  Note that the tilde is used as a delay ONLY in
  3645.      strings that are sent to the modem.  In other strings the tilde is
  3646.      used as a tilde.
  3647.  
  3648. Finally, curly braces { } are very special characters and may not be used
  3649. as data in the support files.  They are represented as follows, using
  3650. parentheses:
  3651.  
  3652.      Left curly brace       ^(
  3653.      Right curly brace      ^)
  3654.  
  3655.  
  3656.  
  3657.                                     -70-
  3658.  
  3659. Here is a list of some of the most common control characters and how to
  3660. represent them.  Upper or lower case may be used.
  3661.  
  3662.      Carriage return        ^M or |
  3663.      Linefeed               ^J
  3664.      Tab                    ^I
  3665.      Formfeed               ^L
  3666.      Escape                 ^[
  3667.      Bell                   ^G
  3668.      XOFF                   ^S
  3669.      XON                    ^Q
  3670.      End of file            ^Z
  3671.  
  3672. Here is a table of all ASCII control characters.  Values are decimal:
  3673.  
  3674.      0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  3675.      1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  3676.      2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  3677.      3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  3678.      4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  3679.      5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  3680.      6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  3681.  
  3682. Most ASCII characters (including control characters below 32 and those in
  3683. the extended graphic character set, 128 to 255), may also be typed using
  3684. the ALT-NUMERIC-KEYPAD method as follows:
  3685.  
  3686.      1.   Hold down the Alt key (and keep it down).
  3687.      2.   Enter the ASCII code in decimal using the numeric keypad keys (1,
  3688.           2 or 3 digits are ok).
  3689.      3.   Release the Alt key.
  3690.  
  3691. IMPORTANT!  ASCII 0, 10 and 13 may only be represented with the caret.
  3692.  
  3693.  
  3694.  
  3695.                                     -71-
  3696.  
  3697. ==========  Appendix E   Terminal Emulation
  3698.  
  3699. Terminal Emulation Type is indicated on the Status Line (in the Terminal
  3700. Parameters string).  Available types are:
  3701.  
  3702.      A    ANSI-BBS
  3703.                Used on bulletin boards and other systems.
  3704.  
  3705.      V    VT102 (VT100 compatible)
  3706.                Used on minicomputers and mainframes.
  3707.  
  3708.      T    TTY
  3709.                Supports only the basic control characters.
  3710.  
  3711. The Terminal Emulation Type (as defined by the Default Dialing Parameters
  3712. string) will be set whenever a system is dialed.  It may be overridden for
  3713. the current call by using the Parms field in the Dialing Directory entry. 
  3714. It may also be changed temporarily using the Alt-P key command or the PARMs
  3715. macro function.  The Default Dialing Parameters may be changed using the
  3716. Alt-P key command or the DPARms macro function.
  3717.  
  3718. IMPORTANT!  The Terminal Emulation Type affects only received data (as
  3719. displayed to the screen).  The proper macros must be installed to obtain
  3720. the correct keyboard simulation.  The following sections describe how to do
  3721. this.
  3722.  
  3723.  
  3724. -----=====  ANSI-BBS Keyboard Support
  3725.  
  3726. The sample Macro File, COMMO.MAC, includes macros to use the PC keypad keys
  3727. (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors.  If these
  3728. keys do not seem to work properly, especially if the left arrow seems to
  3729. hang the host, you should try the VT102 keyboard file (see instructions
  3730. below).  Do not set the "V" for display emulation unless the host requires
  3731. it.
  3732.  
  3733.  
  3734. -----=====  VT102 Keyboard Simulation
  3735.  
  3736. The VT102 keyboard simulation macro file, VT102.MAC, works best with the
  3737. enhanced 101-key keyboard (turn on Numlock to use digits 0-9 and the
  3738. period).
  3739.  
  3740. IMPORTANT!  The PgUp and PgDn keys are part of VT102 emulation.  To bring
  3741. up the upload or download protocol menus while VT102.MAC is loaded, press
  3742. Alt-Z.
  3743.  
  3744. VT102.MAC will load automatically if "vt102" is specified as the Linked
  3745. Macro in a Dialing Directory entry.  For example:
  3746.  
  3747.   University UNIX  {555-1234} {password} {vt102} {,,,V}
  3748.  
  3749.  
  3750.  
  3751.                                     -72-
  3752.  
  3753. Notice also the presence of the "V" in the parms field, which enables the
  3754. display portion of the VT102 emulation.  VT102 is a superset of VT100.
  3755.  
  3756. The following special VT102 keyboard functions are supported.  The first
  3757. column is the PC key; the second column is the corresponding VT102 function
  3758. (^ indicates the Ctrl key):
  3759.  
  3760.           F1 ... F4              PF1 ... PF4
  3761.           Arrows                 Four cursor keys
  3762.           Home                   Home cursor
  3763.           ^Home                  Insert line
  3764.           PgUp                   Page up
  3765.           ^PgUp                  Delete line
  3766.           PgDn                   Page down
  3767.           ^PgDn                  Clear screen
  3768.           End                    End of line
  3769.           Ins                    Insert mode
  3770.           Del                    DEL
  3771.           ^(BS)                  Ctrl backspace (DEL)
  3772.           Keypad *               Keypad ,
  3773.           Keypad -               Keypad -
  3774.           Keypad +               Keypad Enter
  3775.  
  3776. VT102 numeric keypad keys are auto-switched by the host system between
  3777. numeric mode and application mode.  The four cursor keys are auto-switched
  3778. between cursor mode and application mode.
  3779.  
  3780. This file may be modified to create any keyboard support you desire (see
  3781. description of VTCUr and VTPAd functions in the section "{COMMO} Macro
  3782. Functions."
  3783.  
  3784.  
  3785. -----=====  VT220 Keyboard Simulation
  3786.  
  3787. VT220 keyboard simulation uses the file VT220.MAC.  All of the statements
  3788. in the previous section apply (substitute the term VT220 for VT102).
  3789.  
  3790. Note that {COMMO} does NOT support the enhanced display functions of the
  3791. VT220 terminal (it supports VT102).  Therefore the results may not be
  3792. satisfactory in all cases.
  3793.  
  3794. The following special VT220 keyboard functions are supported:
  3795.  
  3796.           F1 ... F4              PF1 ... PF4
  3797.           F5                     Break
  3798.           F6 ... F12             F6 ... F12
  3799.           Alt-F11 ... Alt-F14    F11 ... F14
  3800.           Alt-F15                Help
  3801.           Alt-F16                Do
  3802.           Alt-F17 ... Alt-F20    F17 ... F20
  3803.  
  3804.           Arrows                 Four cursor keys
  3805.           Home                   Find
  3806.  
  3807.  
  3808.  
  3809.                                     -73-
  3810.  
  3811.           Ins                    Insert here
  3812.           Del                    Remove
  3813.           End                    Select
  3814.           PgUp                   Prev screen
  3815.           PgDn                   Next screen
  3816.  
  3817.           Keypad *               Keypad ,
  3818.           Keypad -               Keypad -
  3819.           Keypad +               Keypad Enter
  3820.           Backspace              DEL
  3821.  
  3822.  
  3823. -----=====  Printer Support
  3824.  
  3825. {COMMO} supports the ANSI/VT102 printer functions, controlled by the remote
  3826. system:
  3827.  
  3828.      The "Printer ON/OFF" function will turn {COMMO}'s Print Log ON/OFF.
  3829.  
  3830.      The "Dedicated Printing" function will send all input from the serial
  3831.      port directly to the printer.  This allows for "transparent"
  3832.      transmission of printer data, including control codes.
  3833.  
  3834.      The "Print Screen" function will print the entire current screen.
  3835.  
  3836. The printer should be on and ready to print when these functions are used
  3837. or the system may hang.  When "Dedicated Printing" is active no characters
  3838. will be displayed on the screen.
  3839.  
  3840. TIPS on using terminal emulation:
  3841.  
  3842.  *   Whenever a change is made, a reset of mode parameters will be
  3843.      performed.  It is therefore important that the change be made BEFORE
  3844.      (or at the time of) connecting with a host (mode settings may be
  3845.      transmitted by the host).
  3846.  
  3847.  *   If some screens do not look right when VT102 emulation is used, you
  3848.      may need to turn LINEWRAP off (it defaults to on).
  3849.  
  3850.      Linewrap may be turned on/off locally using the DISPlay macro
  3851.      function.  Place one of the following in your login macro (or assign
  3852.      one of them to a key and execute it manually):
  3853.  
  3854.           {display ,,,^[[?7h}      linewrap ON
  3855.           {display ,,,^[[?7l}      linewrap OFF
  3856.  
  3857.  *   {COMMO} will support auto-switching to 132 column mode, but you must
  3858.      define the hardware video mode that causes your video adapter to
  3859.      switch to 25x132 (rows, columns).  See the item {avm=} under "[Alt-G] 
  3860.      Edit Setup File" for details.  Note that your video adapter should be
  3861.      in 25x80 when you start {COMMO}.
  3862.  
  3863.  
  3864.  
  3865.                                     -74-
  3866.  
  3867.  *   If colors do not always look right, it may be necessary to set the
  3868.      Terminal Screen colors in the Setup File to {07}.  See the note under
  3869.      "Colors" in the section "[Alt-G]  Edit Setup File."
  3870.  
  3871.  
  3872.  
  3873.                                     -75-
  3874.  
  3875. ==========  Appendix F   Usage Log Format
  3876.  
  3877. Example of a connect entry:
  3878.  
  3879.   {On}   06/10/93  18:11     9600 bps    Channel 1
  3880.  
  3881.      {On}
  3882.           A connection was made.
  3883.      06/10/93
  3884.           Date of connect.
  3885.      18:11
  3886.           Time of connect.
  3887.      9600 bps
  3888.           Speed of connect as reported by the "success response string."
  3889.      Channel 1
  3890.           Name of system called.
  3891.  
  3892.  
  3893. Example of a disconnect entry:
  3894.  
  3895.   {Off}  06/10/93  18:12     2:17        1 617 354 3230 
  3896.  
  3897.      {Off}
  3898.           A call was terminated.
  3899.      06/10/93
  3900.           Date of termination.
  3901.      18:13
  3902.           Time of termination.
  3903.      2:17
  3904.           Duration of call in minutes:seconds.
  3905.      1 617 354 3230
  3906.           Telephone number of called system.  Includes override prefix
  3907.           and/or suffix, if present.
  3908.  
  3909.  
  3910. Example of a file transfer entry:
  3911.  
  3912.   {RZ} 0  c:\ul\nlbbs.rep  188988  1608 cps  0 errors 
  3913.  
  3914.      {RZ}
  3915.           File was received with Zmodem.
  3916.      0
  3917.           0 means the file was transferred (or resumed) successfully.  1
  3918.           means the file was not completed.
  3919.  
  3920.  
  3921.  
  3922.                                     -76-
  3923.  
  3924.      c:\ul\nlbbs.rep
  3925.           Path\filename of file.
  3926.      188988
  3927.           Bytes transferred (may not be equal to the size of the file if
  3928.           the transfer was incomplete or if the Zmodem resume feature was
  3929.           used).
  3930.      1608 cps
  3931.           Rate at which data was transferred in characters per second.  The
  3932.           clock is not started until initial protocol handshaking has been
  3933.           completed.  "** cps" indicates transfer time was too short or
  3934.           there was an error in the computation.
  3935.      0 errors
  3936.           Total number of errors (corrected if transfer was successful).
  3937.  
  3938. NOTE:  You may configure an external protocol program to make log entries
  3939. to your {COMMO} Usage Log file.  The format of these entries is explained
  3940. in the documentation for the protocol program.
  3941.  
  3942.  
  3943.  
  3944.                                     -77-
  3945.  
  3946. ==========  Appendix G   Error Message Explanations
  3947.  
  3948. If you get an error message that you don't understand, check below for
  3949. additional information.
  3950.  
  3951. __________________________________
  3952.  
  3953. A macro is running.  Terminate it?
  3954. __________________________________
  3955.  
  3956.      This message comes from a macro that is using the SETEsc function.  It
  3957.      is used as a warning to prevent accidental termination of macros. 
  3958.      Answer "No" to continue processing, "Yes" to stop.
  3959.  
  3960. _______________________________
  3961.  
  3962. Cannot locate command processor
  3963. _______________________________
  3964.  
  3965.      This is an unusual condition.  Type "SET" at the DOS prompt and be
  3966.      sure there is a "COMSPEC=" in the list.  If there is, make sure that
  3967.      COMMAND.COM is in the path specified.
  3968.  
  3969. ____________________________________
  3970.  
  3971. Capture File Closed, DISK IS FULL!
  3972. Information not saved, DISK IS FULL!
  3973. ____________________________________
  3974.  
  3975.      The Capture File and Screen Image File should be edited regularly to
  3976.      ensure that they are not occupying too much disk space.
  3977.  
  3978. _____________________
  3979.  
  3980. Dial command too long
  3981. _____________________
  3982.  
  3983.      The dial command is limited to 128 characters.
  3984.  
  3985. ________________________________
  3986.  
  3987. Edit space full!  See Appendix K
  3988. ________________________________
  3989.  
  3990.      When any file that can be edited with {COMMO}'s Internal Editor is
  3991.      loaded, expansion space is allocated.  The amount of expansion space
  3992.      is determined by the "esf" item in the Setup File (default is 8k).  If
  3993.      this space fills up while editing, the warning will appear.
  3994.  
  3995.      Exiting {COMMO} and restarting, or using the Swap to Disk, will
  3996.      restore the full expansion space.  The total size of file plus
  3997.      expansion cannot exceed 64k bytes.
  3998.  
  3999.  
  4000.  
  4001.                                     -78-
  4002.  
  4003. ________________
  4004.  
  4005. File is not text
  4006. ________________
  4007.  
  4008.      {COMMO} support files and other files edited with the Internal Editor
  4009.      must be proper ASCII text files.  They should have a CR/LF at the end
  4010.      of each line and should not contain other control characters.
  4011.  
  4012. ___________________________
  4013.  
  4014. Hardware flow control pause
  4015. ___________________________
  4016.  
  4017.      Hardware Flow Control (RTS/CTS handshaking) is in effect and the
  4018.      remote system (or your modem) has requested a pause.  Try waiting a
  4019.      few seconds for the pause to clear.  If that fails, try setting
  4020.      {hfc=auto} in your Setup File.  Be sure to restart {COMMO} after
  4021.      making this change.
  4022.  
  4023. __________________________
  4024.  
  4025. Macro location not in file
  4026. __________________________
  4027.  
  4028.      An attempt has been made to RETUrn to a Macro File that has been
  4029.      modified.  Avoid editing Macro Files that are in use.
  4030.  
  4031. _______________________________
  4032.  
  4033. Not available during evaluation
  4034. _______________________________
  4035.  
  4036.      You have attempted to use a feature that is available only to
  4037.      registered users.  If you are registered, be sure you have followed
  4038.      the instructions in your registration letter.
  4039.  
  4040. ________________________________
  4041.  
  4042. Not enough memory
  4043. Not enough memory for Scrollback
  4044. ________________________________
  4045.  
  4046.      These messages may occur at program startup.  Check the following:
  4047.  
  4048.      1)   {COMMO} cannot allocate its internal buffers.  You must make more
  4049.           memory available.
  4050.  
  4051.      2)   {COMMO} cannot load the Dialing Directory and/or Macro File.  Try
  4052.           reducing the size of either of these files.  Removing comments
  4053.           may help.  Or make more memory available.
  4054.  
  4055.  
  4056.  
  4057.                                     -79-
  4058.  
  4059.      3)   {COMMO} cannot allocate the Scrollback Buffer.  Reduce its size
  4060.           or make more memory available.
  4061.  
  4062. _______________________
  4063.  
  4064. Not enough memory
  4065. Program file not found
  4066. Unable to execute shell
  4067. _______________________
  4068.  
  4069.      A problem was encountered during Shell to DOS or EXEC:
  4070.  
  4071.      1)   There may not be enough memory to execute the command processor
  4072.           or external program you have specified.
  4073.  
  4074.      2)   The program file you specified in an EXECute function using the
  4075.           "D" switch cannot be located.  Make sure you specify the full
  4076.           path and filename.
  4077.  
  4078.      3)   Some other system error condition may exist.  Make sure that
  4079.           COMMAND.COM is still available in the "COMSPEC=" path.
  4080.  
  4081. _________________________
  4082.  
  4083. Not enough variable space
  4084. _________________________
  4085.  
  4086.      {COMMO} has run out of variable space.  Macros should delete (set to
  4087.      null) variables that are no longer in use.  If you need more space,
  4088.      use the "/vnnnnn" command line switch.
  4089.  
  4090. ____________________________
  4091.  
  4092. Swap Failure, exiting to DOS
  4093. ____________________________
  4094.  
  4095.      This message will appear if {COMMO} cannot be fully restored when
  4096.      returning from a Swap to Disk.  This can result from one of these
  4097.      conditions:
  4098.  
  4099.           1)   Unable to read the Swap File (file not found or file is
  4100.                unreadable).
  4101.  
  4102.           2)   Unable to allocate the necessary memory (a TSR may have been
  4103.                loaded above {COMMO}'s kernel).
  4104.  
  4105.  
  4106.  
  4107.                                     -80-
  4108.  
  4109. ________________________
  4110.  
  4111. Unable to open file
  4112. Unable to open Help File
  4113. File not found
  4114. Path not found
  4115. Too many files
  4116. ________________________
  4117.  
  4118.      Check the following:
  4119.  
  4120.      1)   Your "SET COMMO=" command in your AUTOEXEC.BAT file.  It may be
  4121.           specifying the wrong directory.
  4122.      2)   That the path exists where the file should be.
  4123.      3)   That the file itself exists (this won't be the problem if the
  4124.           file is being created).
  4125.      4)   Too many files may be open.  You may need to increase your FILES=
  4126.           parameter in CONFIG.SYS.
  4127.      5)   The Online Help File must be less than 64K bytes in size.
  4128.      6)   You cannot use an open Capture File for any other purpose.
  4129.  
  4130. ____________________________________________
  4131.  
  4132. WARNING: another copy of {COMMO} is running!
  4133. ____________________________________________
  4134.  
  4135.      You probably Shelled to DOS and started another copy of {COMMO}.  This
  4136.      warning is provided to prevent overwriting of support files that have
  4137.      changed.
  4138.  
  4139.      If it is necessary to Shell to DOS and run {COMMO} again, use the Swap
  4140.      to Disk feature which will preserve any changes to your Dialing
  4141.      Directory, etc.  This detection does not work between DESQview
  4142.      windows.
  4143.  
  4144.  
  4145.  
  4146.                                     -81-
  4147.  
  4148. ==========  Appendix H   {COMMO} Macro Key-labels
  4149.  
  4150. Key-labels are special macro labels that let you start a macro by pressing
  4151. the associated key (they can also be the targets of GOTO, CALL, etc.). 
  4152. They fall into two general categories: predefined and user-defined.
  4153.  
  4154.  
  4155. ----------  Table of PREDEFINED Key-labels
  4156.  
  4157. The caret (^) indicates the Ctrl key.  "Normal" means unshifted.
  4158.  
  4159.      Key Name     Key-label     Key Name     Key-label
  4160.      ________     _________     ________     _________
  4161.  
  4162.      Normal-F1     nf1   ...    Normal-F10    nf0
  4163.      Normal-F11    nfa          Normal-F12    nfb
  4164.  
  4165.      Ctrl-F1       cf1   ...    Ctrl-F10      cf0
  4166.      Ctrl-F11      cfa          Ctrl-F12      cfb
  4167.  
  4168.      Shift-F1      sf1   ...    Shift-F10     sf0
  4169.      Shift-F11     sfa          Shift-F12     sfb
  4170.  
  4171.      Alt-F1        af1   ...    Alt-F10       af0
  4172.      Alt-F11       afa          Alt-F12       afb
  4173.  
  4174.      Alt-A         ala   ...    Alt-Z         alz
  4175.      Alt-1         al1   ...    Alt-0         al0
  4176.      Alt =         al=          Alt -         al-
  4177.  
  4178.      Escape        esc          Grey *        gr*
  4179.      Grey -        gr-          Grey +        gr+
  4180.  
  4181.      Backspace     bsp          ^Backspace    cbs
  4182.      Tab           tab          Shift-tab     stb
  4183.      Enter         ent          ^Enter        cen
  4184.  
  4185.      Home          hom          End           end
  4186.      PgUp          pgu          PgDn          pgd
  4187.      Up-Arrow      upa          Down-Arrow    dna
  4188.      Left-Arrow    lfa          Right-Arrow   rta
  4189.      Insert        ins          Delete        del
  4190.  
  4191.      ^Home         chm          ^End          cnd
  4192.      ^PgUp         cpu          ^PgDn         cpd
  4193.      ^Right-Arrow  cra          ^Left-Arrow   cla
  4194.  
  4195.      Keypad-0      kp0   ...    Keypad-9      kp9
  4196.      Keypad-.      kp.          ^PrtSc        cpr
  4197.  
  4198.  
  4199.  
  4200.                                     -82-
  4201.  
  4202.      Alt-[         al[          Alt-]         al]
  4203.      Alt-;         al;          Alt-'         al'
  4204.      Alt-,         al<          Alt-.         al.
  4205.      Alt-/         al/          Alt-\         al\
  4206.      Alt-*         al*          Alt-`         al`
  4207.      Alt-Kp(-)     ak-          Alt-Kp(+)     ak+
  4208.      Alt-Return    art          Center Key    cky
  4209.  
  4210. TIPS on using key-labels:
  4211.  
  4212.  *   Key-labels are always three characters in length.
  4213.  
  4214.  *   Some key-labels are not available on systems with an older BIOS.  And
  4215.      some keys do not exist on the 83-key keyboard.
  4216.  
  4217.  *   If the same key-label appears more than once, the first occurrence
  4218.      will be used (as with any macro label).
  4219.  
  4220.  *   Key-labels are not case sensitive.
  4221.  
  4222.  *   The Center Key is the Keypad 5 with Numlock off.
  4223.  
  4224.  
  4225. ----------  USER-DEFINED Key-labels
  4226.  
  4227. (Note that this feature is unavailable during shareware evaluation.)
  4228.  
  4229. Almost any key combination on the keyboard may be defined with the "mky"
  4230. item in the Setup File.  See "[Alt-G]  Edit Setup File" in Part I
  4231. (COMMO.DOC).
  4232.  
  4233. TIPS on using user-defined key-labels:
  4234.  
  4235.  *   You may have up to 32 user-defined key-labels.
  4236.  
  4237.  *   User-defined key-labels may be used to "override" predefined key-
  4238.      labels.
  4239.  
  4240.  *   Use Alt-K in the Internal Editor to obtain the scan code for any key.
  4241.  
  4242.  *   Beware that some keys give the same scan code when used with various
  4243.      shift keys (Ctrl, Alt or Shift) as when unshifted.  Some examples are:
  4244.      Space, Esc, Return and Backspace.
  4245.  
  4246.  *   You cannot define keys formed with multiple shift keys.  For example,
  4247.      you cannot use Ctrl-Alt-F1 or Ctrl-Shift-Home.
  4248.  
  4249.  
  4250.  
  4251.                                     -83-
  4252.  
  4253. ==========  Appendix I   List of Reserved Variables
  4254.  
  4255.  
  4256. ----------  USER-DEFINED Reserved Variables
  4257.  
  4258.   _modini     Modem Initialization String
  4259.   _dialpf     Default dialing prefix
  4260.   _dialsf     Default dialing suffix
  4261.   _dialsr     Dialing success response(s)
  4262.   _dialfr     Dialing failure response(s)
  4263.   _dialir     Inter-dial Delay response(s)
  4264.   _dialrt     Dialing response text, available:
  4265.                 (1) after a dialing attempt if _dtc = 1 or 2
  4266.                 (2) in the Inter-dial Delay macro.
  4267.   _uselog     Path\filename of Usage Log
  4268.   _menux      Menu display string, x = 1, 2, 3, etc.
  4269.   _mlabel     List of macro labels for pop-up menu 
  4270.   _menter     Macro label for Enter key in menu
  4271.   _mcolor     Colors used with pop-up menu: text,border
  4272.   _exted      External editor command line
  4273.  
  4274.  
  4275. ----------  BUILT-IN Variables
  4276.  
  4277.   _hom        {COMMO} home directory (e.g., c:\commo\, a:\)
  4278.   _dsk        Current disk (e.g., C:)
  4279.   _dir        Current directory (e.g., \upload, \)
  4280.   _set        Filename of Setup File (e.g., COMMO.SET)
  4281.   _fon        Filename of current Dialing Directory (e.g., COMMO.FON)
  4282.   _mac        Filename of resident Macro File (e.g., COMMO.MAC)
  4283.   _aux        Filename of auxiliary Macro File
  4284.   _edf        Filename for external editor
  4285.   _edl        Line number for external editor
  4286.   _cap        Current Capture File path\filename
  4287.   _scr        Current Screen Image File path\filename
  4288.  
  4289.   _ffn        Find file name (use with FILE function)
  4290.   _ffs        Find file size
  4291.   _ffd        Find file date
  4292.   _fft        Find file time
  4293.  
  4294.   _err        Exit code set by certain functions
  4295.   _met        Error message after Macro Error occurs
  4296.   _dfc        Disk full on capture: 1 = YES, 0 = NO; reset when
  4297.               Capture File is opened, set when disk is full
  4298.   _pos        Position in string
  4299.   _len        Length of string
  4300.  
  4301.   _por        Current serial port number: 1, 2, etc.
  4302.   _spe        Current serial port speed: 2400, 38400, etc.
  4303.   _fmt        Current serial port data format: 8n1, 7e1, etc.
  4304.   _mod        Last speed reported by modem
  4305.   _pad        Current serial port address: 03F8, 02E8, etc.
  4306.  
  4307.  
  4308.  
  4309.                                     -84-
  4310.  
  4311.   _irq        Current IRQ number: 4, 3, etc.
  4312.  
  4313.   _ent        Character(s) sent when Enter is pressed.  Values are:
  4314.                 ^m    (cr)      New Line Mode reset
  4315.                 ^m^j  (cr/lf)   New Line Mode set
  4316.  
  4317.   _nci        Number of characters in input buffer (received and not yet
  4318.               displayed)
  4319.   _sfi        Speech Friendly Interface: 1 = ON, 0 = OFF
  4320.  
  4321.   _dtc        Dialing termination code (available after each dialing
  4322.               attempt).  Values are:
  4323.                 0 = no systems were marked
  4324.                 1 = successful connection
  4325.                 2 = failure response received
  4326.                 3 = timed out
  4327.                 4 = operator intervention
  4328.  
  4329.   _msn        Menu label selection number, from last MENU function
  4330.               (0 for Enter, 1 to 26 for A to Z, etc.)
  4331.   _rem        Remainder from last DIVIde
  4332.   _nam        Current System Name (up to 40 chars)
  4333.   _num        Current Phone Number (up to 40 chars)
  4334.   _pas        Current Password String
  4335.   _ela        Elapsed time in minutes:seconds
  4336.   _ver        Version number text
  4337.  
  4338.   _dat        Full date (format defined in Setup File)
  4339.   _mon        Month, mm
  4340.   _day        Day of the month, dd
  4341.   _yea        Year, yy
  4342.   _dwn        Numeric day of the week: 1=Mon, ... , 7=Sun
  4343.   _dwt        Text day of the week: Mon, Tue, ...
  4344.  
  4345.   _tim        Full time (format defined in Setup File)
  4346.   _24h        24 hour, hh
  4347.   _12h        12 hour, hh
  4348.   _amp        Am/pm indicator, xm
  4349.   _min        Minute, mm
  4350.   _sec        Second, ss
  4351.  
  4352.   _row        Current cursor row
  4353.   _col        Current cursor column
  4354.  
  4355.  
  4356.  
  4357.                                     -85-
  4358.  
  4359. ==========  Appendix J   Macro Functions Listed by Class
  4360.  
  4361.  
  4362. ----------  Variable manipulation
  4363.  
  4364.   SETVariable    Assign a string to a variable name
  4365.   INCRement      Increase a numeric variable
  4366.   DECRement      Decrease a numeric variable
  4367.   MULTiply       Multiply a numeric variable
  4368.   DIVIde         Divide a numeric variable
  4369.   INSTring       Find a string within a string
  4370.   SUBString      Move a substring to a variable
  4371.   LENGth         Determine the length of a string
  4372.  
  4373.  
  4374. ----------  Looking for text
  4375.  
  4376.   AUTO           Auto Receive
  4377.   SETLook        Set LOOKfor parameters
  4378.   LOOKfor        Look for string from port
  4379.   SSLOok         Additional string, send variable
  4380.   CALOok         Additional string, call submacro
  4381.   GOLOok         Additional string, go to macro
  4382.  
  4383.  
  4384. ----------  File Input/Output
  4385.  
  4386.   ROPEn          Open a file for reading
  4387.   READ           Read from a file to a variable
  4388.   RCLOse         Close the read file
  4389.   WOPEn          Open a file for writing
  4390.   WRITe          Write to a file from a variable
  4391.   WCLOse         Close the write file
  4392.  
  4393.  
  4394. ----------  Dialing/connect/disconnect
  4395.  
  4396.   SETDial        Set dialing timers
  4397.   DIAL           Dialing Directory
  4398.   FONFile        Load a new Dialing Directory file.
  4399.   DPARms         Set dialing default parameters
  4400.   HANGup         Drop DTR to hangup
  4401.   MARK           Mark numbers for dialing
  4402.   UNMArk         Unmark Dialing Directory entries
  4403.  
  4404.  
  4405. ----------  Modem control
  4406.  
  4407.   PARMs          Set current terminal parameters
  4408.   LOCAlecho      Local Echo toggle
  4409.   INITmodem      Send modem init string
  4410.   BREAk          Send a Break signal
  4411.   LIGHts         Signal Lights toggle
  4412.  
  4413.  
  4414.  
  4415.                                     -86-
  4416.  
  4417.   SIGNal         Set state of hardware signals
  4418.   SPOCtrl        Serial port output control
  4419.  
  4420.  
  4421. ----------  Send/receive data
  4422.  
  4423.   ASCIiup        ASCII Upload
  4424.   SEND           Send a text string
  4425.   CAPMode        Set Capture Mode
  4426.   CAPTure        Capture File Options
  4427.   SETGet         Set GETString parameters
  4428.   GETString      Get a string from the modem
  4429.   RXMOdem        Receive a file using Xmodem
  4430.   RYMOdem        Receive a file using Ymodem
  4431.   RZMOdem        Receive a file using Zmodem
  4432.   SXMOdem        Send a file using Xmodem
  4433.   SYMOdem        Send a file using Ymodem
  4434.   SZMOdem        Send a file using Zmodem
  4435.   PASSword       Send current password
  4436.   RTRAn          Maintain Receive Translate Table
  4437.   STRAn          Maintain Send Translate Table
  4438.   VTCUr          VT102 cursor key strings
  4439.   VTPAd          VT102 keypad key strings
  4440.  
  4441.  
  4442. ----------  Testing
  4443.  
  4444.   COMPare        Compare a variable to a string
  4445.   IFCOndition    Test Condition Flag
  4446.   IFERrorlevel   Test Exit Codes
  4447.   IFEXist        Test for existence of file(s)
  4448.   IFCArrier      Test for presence of carrier detect
  4449.  
  4450.  
  4451. ----------  Macro control
  4452.  
  4453.   CALL           Execute a macro
  4454.   RETUrn         Return from a CALL
  4455.   PUSHstack      Push a location to the macro stack
  4456.   POPStack       Pop from the macro stack
  4457.   GOTO           Transfer control to a label
  4458.   UNLOad         Release the auxiliary Macro File from memory
  4459.   STOP           Stop macro execution
  4460.   PAUSe          Pause for interval 1-999 seconds
  4461.   HOLD           Hold until specified 24 hr time
  4462.   NOCArrier      Set a label to GOTO when carrier is lost
  4463.   SETEsc         Set a label to GOTO on Esc
  4464.   SETR           Set a label to GOTO when a Macro Error occurs
  4465.  
  4466.  
  4467. ----------  Video/sound related
  4468.  
  4469.   CLEAr          Clear Screen
  4470.  
  4471.  
  4472.  
  4473.                                     -87-
  4474.  
  4475.   CURSor         Terminal Screen cursor toggle
  4476.   DISPlay        Display a string to the screen
  4477.   SCREen         Screen Image Save
  4478.   SFICtrl        Speech Friendly Interface control
  4479.   SPDCtrl        Serial port display control
  4480.   STATusline     Status Line on/off toggle
  4481.   VIDEo          Change to an alternate video mode
  4482.   WINDow         Preserve window display
  4483.  
  4484.   SOUNd          Master Sound toggle
  4485.   ALARm          Ring the alarm
  4486.   BEEP           Play a sequence of sounds
  4487.  
  4488.  
  4489. ----------  Miscellaneous
  4490.  
  4491.   CHATmode       Chat Mode toggle
  4492.   DOORway        Doorway Mode toggle
  4493.   ELAPse         Reset the elapsed timer
  4494.   EDIT           Edit a file
  4495.   EXECute        Execute a DOS command
  4496.   EXIT           Exit {COMMO}
  4497.   FILE           Find directory entry information
  4498.   HELP           Online Help topic
  4499.   INFOrm         Display an advisory message
  4500.   INPUt          Input from the keyboard
  4501.   KEYStuff       Put key codes into the keyboard buffer
  4502.   MACRo          Macro File window
  4503.   MENU           Create a pop-up macro menu
  4504.   NOOP           No-op function, does nothing
  4505.   OFFLog         Make an {Off} entry in the Usage Log
  4506.   PRINtlog       Print Log toggle
  4507.   SCROllback     Display Scrollback Buffer
  4508.   SETUp          Edit Setup File
  4509.   SHELl          Shell to DOS
  4510.   TOGGles        Set Toggles
  4511.  
  4512.  
  4513.  
  4514.                                     -88-
  4515.  
  4516. ==========  Appendix K   {COMMO} Support Files
  4517.  
  4518. The {COMMO} support files are standard ASCII text files and may be modified
  4519. with any editor (or word processor in "non-document" mode).  From within
  4520. {COMMO} they may be edited with {COMMO}'s Internal Editor.  Each support
  4521. file may be up to 64k in size (if there is enough memory).
  4522.  
  4523. Each line in a support file should be no longer than 255 characters and
  4524. should end with a cr/lf pair (which are not included in the length).  The
  4525. only characters not allowed in literal form in the support files are ASCII
  4526. 0, 10 and 13.  Where necessary, these may be represented symbolically as
  4527. shown in Appendix D.  For example, an ASCII 13 would be written as ^M.
  4528.  
  4529. TIPS on using {COMMO} support files:
  4530.  
  4531.  *   All support files must reside in the {COMMO} home directory.
  4532.  
  4533.  *   A file currently in memory may be different from the file on disk
  4534.      (files are saved automatically at certain times).  Therefore it is
  4535.      advisable to use an external editor ONLY in the Swap to Disk (files
  4536.      are saved prior to -- and reloaded after -- the Swap to Disk).
  4537.  
  4538.  
  4539. ----------  The Internal Editor
  4540.  
  4541. {COMMO}'s Internal Editor is provided for your convenience.  It is not
  4542. intended to be a comprehensive text editor.  An external editor (see below)
  4543. should be used if more editing power is desired.  The Internal Editor may
  4544. be used to edit {COMMO} support files or any other text file smaller than
  4545. 64k.
  4546.  
  4547. When a file that can be edited is loaded, a fixed amount of expansion space
  4548. is allocated (no more than 64k total).  The amount of expansion space is
  4549. determined by the {esf=...} item in the Setup File.  The Internal Editor
  4550. will warn you while editing if the expansion space fills up, at which point
  4551. you may reload the file or restart {COMMO} if you wish to continue editing
  4552. (the file will be saved automatically).
  4553.  
  4554. Key assignments for the Internal Editor are given in Online Help.  A Color
  4555. Chart will be displayed in the editor when F7 is pressed (useful in the
  4556. Setup File and for the DISPlay function in Macro Files).
  4557.  
  4558.  
  4559. ----------  Using an External Editor
  4560.  
  4561. (Note that this feature is unavailable during shareware evaluation.)
  4562.  
  4563. An external text editor may be used to edit the Dialing Directory and Macro
  4564. Files directly from their respective windows.  Your editor's command line
  4565. is first defined in the reserved variable "_exted".  Then you simply press
  4566. Alt-E instead of "E" to use your editor instead of the Internal Editor.
  4567.  
  4568.  
  4569.  
  4570.                                     -89-
  4571.  
  4572. TIPS on using an external editor:
  4573.  
  4574.  *   The file will be saved prior to running the editor (if changed), and
  4575.      it will be reloaded upon return.
  4576.  
  4577.  *   Two built-in variables provide the filename and the line number to be
  4578.      used on the editor's command line:
  4579.  
  4580.           _edf    The filename of the last file displayed (or current).
  4581.           _edl    The current line number of the cursor within the file.
  4582.  
  4583.      These may be used as in this Setup File example:
  4584.  
  4585.           {set _exted,c:\util\editor.exe %_hom%%_edf /n%_edl}
  4586.  
  4587.      NOTE:  The "_exted" variable may also be defined in a macro. 
  4588.  
  4589.  *   The command line is run as if it appeared in an {exec-DN...} function
  4590.      -- i.e., direct, no clear and no swap.  This makes it as fast and 
  4591.      seamless as possible.  If you need to use the DOS command processor
  4592.      (e.g., to run a batch file or to search the path), define the command
  4593.      like this:
  4594.  
  4595.           {set _exted,c:\command.com /c editor %_hom%%_edf /n%_edl}
  4596.  
  4597.  
  4598. ----------  The Setup File, COMMO.SET
  4599.  
  4600. The Setup File contains settings for many important parameters.  The first
  4601. time you run {COMMO} you should use the Alt-G key command to edit this file
  4602. to your own needs.
  4603.  
  4604. IMPORTANT!  If you edit the Setup File, the changes will not take effect
  4605. until you restart {COMMO}.
  4606.  
  4607. See "[Alt-G]  Edit Setup File" for details on each item.
  4608.  
  4609.  
  4610. ----------  The Dialing Directory, COMMO.FON
  4611.  
  4612. The Dialing Directory file contains information about each system that you
  4613. will be calling, including the telephone number, password, Linked Macro and
  4614. Terminal Parameter overrides.  Use the Alt-D key command to dial numbers
  4615. and to edit this file.
  4616.  
  4617. A new Dialing Directory file may be loaded at any time using the FONFile
  4618. macro function, or manually within the Dialing Directory window.  This
  4619. feature may result in somewhat higher memory usage during a {COMMO}
  4620. session.  (Note that this feature is unavailable during shareware
  4621. evaluation.)
  4622.  
  4623. See also "[Alt-D]  Dialing Directory."
  4624.  
  4625.  
  4626.  
  4627.                                     -90-
  4628.  
  4629.  
  4630. ----------  The Resident Macro File, COMMO.MAC
  4631.  
  4632. The resident Macro File is loaded when you start {COMMO} and contains
  4633. macros that are available at all times.  Use the Alt-M key command to
  4634. select a macro for execution and to edit the resident Macro File.  A
  4635. complete description of {COMMO} macros is given in Part II (MACRO.DOC). 
  4636. Summary lists of macro functions and key designators can be found in the
  4637. appendices and also in Online Help.
  4638.  
  4639. See also "[Alt-M]  Macro File" for information about compiling Macro Files.
  4640.  
  4641.  
  4642. ----------  The Auxiliary Macro File
  4643.  
  4644. An auxiliary Macro File may be loaded (or replaced) at any time using the
  4645. CALL and GOTO macro functions.  A new auxiliary file may be loaded manually
  4646. within the Macro File window.  An auxiliary may also be specified in a
  4647. Dialing Directory entry and will load when a connection is made with the
  4648. remote system.
  4649.  
  4650. When an auxiliary is loaded, the auxiliary and resident files behave as one
  4651. Macro File.  Note that the auxiliary is positioned logically AHEAD of the
  4652. resident, allowing macros in the resident to be overridden when necessary. 
  4653. You can CALL and GOTO between the files, but a macro cannot span the two
  4654. files.
  4655.  
  4656. The current auxiliary may be released from memory using the UNLOad macro
  4657. function.
  4658.  
  4659. See also "[Alt-M]  Macro File" for information about compiling Macro Files.
  4660.  
  4661.  
  4662. ----------  The Online Help File, COMMO.HLP
  4663.  
  4664. The Online Help File contains the information for {COMMO}'s context-related
  4665. Online Help.  This file can be customized.
  4666.  
  4667. See "F1  How to Use Online Help."
  4668.  
  4669.  
  4670. ----------  Changes to the Support Files
  4671.  
  4672. Whenever a change is made to any file, the internal change flag is set for
  4673. that file (indicated by an "*" next to the column number in the Internal
  4674. Editor).  Changes are normally saved automatically at program exit or if
  4675. another file is loaded, but you may press Alt-F in the Internal Editor to
  4676. immediately save any file to disk.
  4677.  
  4678. If you do not wish to save your changes, you may press Alt-Q while in the
  4679. Internal Editor.  This will reset {COMMO}'s change flag and the file will
  4680. not be saved automatically (however, any subsequent changes to the file
  4681. will set the change flag again).
  4682.  
  4683.